home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / packet / rswd31 / rosesys.txt < prev    next >
Text File  |  1990-11-08  |  127KB  |  2,597 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                           
  8.                                           
  9.                                           
  10.                                           
  11.                         RATS Open Systems Environment (ROSE)
  12.                                           
  13.                                ROSE X.25 Packet Switch
  14.                                           
  15.                                 System Manager Manual
  16.                                           
  17.                                           
  18.                                           
  19.                                           
  20.                                           
  21.                                          by
  22.                                           
  23.                                Thomas A. Moulton, W2VY
  24.                                           
  25.                                           
  26.                                           
  27.                                           
  28.                                           
  29.                                           
  30.                                           
  31.                                           
  32.                                           
  33.                                           
  34.                                           
  35.                                           
  36.                                           
  37.                                           
  38.                                           
  39.                                           
  40.                                           
  41.                                           
  42.                                           
  43.                                    Distributed by
  44.                                           
  45.                                           
  46.                                           
  47.                                           
  48.                                           
  49.                                   Thomas A. Moulton
  50.                                  150 William Street
  51.                                   Clifton, NJ 07014
  52.                               United States of America
  53.                                           
  54.  
  55.  
  56.  
  57.  
  58.  
  59.      
  60.      Introduction                                               1
  61.      Use Guidelines                                             1
  62.      Notational Syntax                                          1
  63.      Addressing                                                 1
  64.      Routing                                                    2
  65.      Network Definition                                         3
  66.      Network Configuration                                      4
  67.      Configuration of Default Parameters                        5
  68.      Configuration of This Switch                               6
  69.      Configuration of This Switch                               6
  70.      Configuration of Local Switches                            9
  71.      Configuration of Routing Information                      10
  72.      Additional Configuration Commands                         12
  73.      Special Characters to the Configuration Program           13
  74.      ROSE X.25 Packet Switch Applications                      13
  75.      LOADER Application                                        14
  76.      LOADABLE APPLICATIONS                                     16
  77.      BOOTER Application                                        16
  78.      CONFIG Application                                        16
  79.      HEARD Application                                         18
  80.      INFO Applications                                         19
  81.      MHEARD Application                                        20
  82.      MEMSIZ Application                                        20
  83.      USERS Application                                         20
  84.      Running ROSEPWD                                           21
  85.      Running the Configuration Program                         21
  86.      Configuration Program Command Summary and Error Messages  22
  87.      Programming the EPROM                                     22
  88.      Permanent Configuration of the Switch                     24
  89.      Power ON Indications for TNC-2                            26
  90.      Configuring a switch for the first time                   26
  91.      Configuring a switch for the second time                  29
  92.      Configuring a Remote Switch                               30
  93.      Loading a Switch after a Power Failure                    30
  94.      Hardware Installation - TNC-2 or Clone                    30
  95.      Hardware Installation - PacComm DR-100/DR-200             32
  96.      Hardware Modifications - TNC-2 or Clone                   32
  97.      Hardware Modifications - DR-100/DR-200                    33
  98.      Asynchronous Communications                               34
  99.      Asynchronous Radio Port Cables                            36
  100.      Wiring two TNCs for Back-to-Back Operation                37
  101.      Differences between ROSE and Net/ROM Back-to-Back Cable   37
  102.      Wiring many TNCs for Back-to-Back Operation               37
  103.      Conclusion                                                38
  104.      Appendix 1 - Files Supplied in archive                     1
  105.      Appendix 2 - ROSE X.25 Packet Switch User's Manual         1
  106.      Appendix 3 - Network Configuration Example                 1
  107.      Appendix 4 - Terminology                                   1
  108.      Appendix 5 - Shifted ASCII Table                           2
  109.  
  110.  
  111.                                                                         1
  112.  
  113.  
  114.      Introduction     Introduction
  115.  
  116.                The ROSE  X.25 Packet Switch is an  advanced replacement for
  117.           the common  digipeater or  other node  switching EPROM.  The ROSE
  118.           Switch represents  the state  of  the  art  in  packet  switching
  119.           technology using international standard protocols. It is based on
  120.           the CCITT  X.25 Network  Layer, and  the ARRL  AX.25  Link  Layer
  121.           Protocols.
  122.  
  123.                The ROSE X.25 Packet Switch is the best solution for Amateur
  124.           Packet Radio  Networking.  A  ROSE  Switch  can  be  accessed  by
  125.           standard AX.25 TNCs supporting the AX.25 Link Layer protocol. The
  126.           AX.25 Link  Layer protocol is also used on paths between backbone
  127.           switches. The X.25 Network Layer protocol is used by the switches
  128.           to transfer  the users'  data through the network. See Appendix 2
  129.           (Users Manual) for a complete list of features.
  130.  
  131.      Use Guidelines     Use Guidelines
  132.  
  133.                The ROSE  switch is  a shareware  product within the Amateur
  134.           Radio Community.  The executable  firmware is available from many
  135.           sources, including many land-line BBSs, as well directly from the
  136.           author. The  switch firmware  may be  used  free  of  charge  for
  137.           amateur radio purposes.
  138.  
  139.                Shareware registration will entitle the user to notification
  140.           of  updates,  information  about  new  applications  as  well  as
  141.           assistance with network coordination. Informational mailings will
  142.           be sent bimonthly. See Appendix 6, ROSE Registration Form.
  143.  
  144.                Answers to  questions,  special  help,  such  as  customized
  145.           EPROMs,  assistance  with  configurations,  can  be  arranged  by
  146.           contacting the author.
  147.  
  148.                Commercial use  of the  ROSE X.25 Packet Switch is expressly
  149.           forbidden.  Contact   the   author   for   commercial   licensing
  150.           information.
  151.  
  152.      Notational Syntax     Notational Syntax
  153.  
  154.                Words that have the first character capitalized are being
  155.           emphasized and are defined in Appendix 4 Terminology. In examples of                                                   Terminology                
  156.           interactions with the Switch commands you typed are underlined and                                                              __________    
  157.           replies from the Switch are bold.                                      bold 
  158.  
  159.      Addressing     Addressing
  160.  
  161.                The ROSE  X.25 Packet  Switch supports the global addressing
  162.           plan adopted  by CCITT and ISO. This plan includes a country code
  163.           and a  national network  number.  The  ROSE  Switch  follows  the
  164.           numbering plan  in use  in the  national  X.25  packet  switching
  165.           network, most packet networks follow the telephone numbering plan
  166.           used in  that country. North America uses the telephone Area Code
  167.           and Exchange.
  168.  
  169.  
  170.                                                                         2
  171.  
  172.  
  173.                This system  will allow  a user to request a connection with
  174.           another station  without any  concern given to the exact path the
  175.           data will  follow. This  is in  sharp contrast  to the explicitly
  176.           specified approach  used by  digipeaters. The motivation for this
  177.           is that the general user population doesn't care to, or have time
  178.           to, keep  abreast of  the networking  changes  over  time.    The
  179.           routing is  under your  complete control, so users can't clog the
  180.           network with  retries on  obsolete RF  paths. Users  only need to
  181.           know the  Network Address  of the  destination, which  is like  a
  182.           telephone number.
  183.  
  184.                The ROSE  Switch may  be configured  with several  paths  to
  185.           remote Area  Codes or countries. Each of the specified links will
  186.           be tried  in the order they were specified to find an operational
  187.           route. This is an improvement on several existing amateur systems
  188.           which can  only provide  implicit destination routing to switches
  189.           known by the source switch.
  190.  
  191.                The  telephone   exchanges  are   allocated  based   on  the
  192.           population density  of each   area. A single ROSE X.25 Switch can
  193.           provide RF  coverage of  many different exchanges. A full list of
  194.           exchanges that  the switch  should  handle  as  its  own  can  be
  195.           specified.
  196.  
  197.                The addressing  also needs  to support  routing to different
  198.           countries, the  X.121 standard handles this with a prefix country
  199.           code. In  data networks  the country  code  is  called  the  Data                                                                       D   
  200.           Network Identification  Code (DNIC),  the ROSE Switch supports up          N       I               C                                        
  201.           to 8  different DNICS, and will be expanded as the networks grow.
  202.           The user  can specify  the DNIC  in the  TNC connect  command  by
  203.           adding an  extra four  digit digipeater  field between the switch
  204.           callsign and  the network  address, for  example  to  connect  to
  205.           VE7APU in Canada you could enter the following command:
  206.  
  207.                     C VE7APU V N2DSY-3,3020,617385
  208.  
  209.                The ROSE  Switch would see the four digit group and the fact
  210.           that another  digit field  followed it  and  merge  the  numbers,
  211.           resulting in an address of 3020617385.
  212.  
  213.                If you get a call from a station that is in a different DNIC
  214.           than the  ROSE Switch you use, it will insert the correct DNIC in
  215.           the digipeater field preceding the network address in the connect
  216.           request. This  insures that  you know  how to reach the user at a
  217.           later date,  as well as providing identification of international
  218.           contacts which  sometimes require  special considerations  by the
  219.           users in the contact.
  220.  
  221.      Routing     Routing
  222.  
  223.                The ROSE  X.25 Packet Switch supports a very flexible static
  224.           routing scheme.  The routing  is static  in that  the the routing
  225.           tables are  not automatically  updated in  any  way.  The  normal
  226.           method of  having automatically updated tables is through the use
  227.  
  228.  
  229.                                                                         3
  230.  
  231.  
  232.           of various broadcasts for routing updates, ROSE does not do this.
  233.           Instead the  system manager  should configure the switch with all
  234.           the reasonable paths for a given address. This avoids the problem
  235.           of short  band openings  that provide  routing information but no
  236.           useful data transfer.
  237.  
  238.                When attempting  to route  a call  request the  switch  will
  239.           obtain the  alternative list  for the  address specified from the
  240.           routing table.  The list  contains  a  sequence  of  which  local
  241.           switches can  handle the  call in  order of the preference of the
  242.           path.
  243.  
  244.                The most  preferred switch  that is  not listed  as "Out  of
  245.           Order" will  be sent  the call  request. If  that switch responds
  246.           with a  network level  error, such as "No Path" or "Out of Order"
  247.           the next  path in  the alternative list will be tried. If it runs
  248.           out of alternatives the call will be cleared with a cause of "Out
  249.           of Order".
  250.  
  251.                A switch  will mark  a local  switch as "Out of Order" if it
  252.           can not  establish network  level communications with the switch.
  253.           The  switch   will  be   considered  as  "Out  of  Order"  for  a
  254.           configurable period of time.
  255.  
  256.                A routing  loop can  occur when  a switch  receives  a  call
  257.           request that  it has  already routed  to another  switch. This is
  258.           detected by  the switch  by examining  the following  information
  259.           from the call request packet; Source Network Address, Source Call
  260.           Sign, Destination Call Sign and a random number.
  261.  
  262.                The random  number is  comprised of  an 8  bit call sequence
  263.           number and  an 8  bit random  number. The call sequence number is
  264.           incremented for each new call request a switch handles. If a loop
  265.           is detected  the second  call request  is cleared  with a network
  266.           level error  and the  preceding switch  will then  try  the  next
  267.           alternative.
  268.  
  269.      Network Definition     Network Definition
  270.  
  271.                Designing local  network topology  can be  an art in itself.
  272.           The following  is a good template that can be used to determine a
  273.           first best  guess as  to how  the various  paths should  be used.
  274.           Once you  have a network operational you should try various paths
  275.           to optimize  the traffic flow.  In many cases gut feelings should
  276.           be tried  as there  are things  we all know about RF paths that I
  277.           haven't been able to put into words.
  278.  
  279.                In order  to define  a network of ROSE X.25 Packet Switches,
  280.           perform the following steps:
  281.  
  282.                1) Draw  a network  layout consisting  of switches  and  the
  283.           usable RF paths between each adjacent switch.
  284.  
  285.  
  286.                                                                         4
  287.  
  288.  
  289.                2) Assign  each switch  a callsign and address consisting of
  290.           the telephone  Area Code  and Exchange  of the  location  of  the
  291.           switch.
  292.  
  293.                3) Prioritize  the reliability  of  each  switch's  outbound
  294.           links.   Preferred  paths  should  have  many  of  the  following
  295.           characteristics;  Solid  paths,  low  volume  paths;  high  speed
  296.           channels; and  low contention.  In general the number of emitters
  297.           on a  given frequency should kept low. Hidden transmitters should
  298.           be eliminated.  All the  emitters should  hear  each  other  well
  299.           enough to  cause the  carrier to  be detected  by the  modem. The                                                                        ___
  300.           shortest path  between two  points is  the  path  with  the  most          _________________________________________________________________
  301.           available band width, not the shortest distance!          ________________________________________________
  302.  
  303.                4) For  each link list the switches within your network that
  304.           can be  reached. If  a switch  shows up more than once decide the
  305.           order that  they should be used, usually "shortest" to "longest".
  306.           Inter-switch traffic on a user channel should be avoided.
  307.  
  308.                5) Next  decide the  best path  for  traffic  from  switches
  309.           outside your  control should  follow.   These can  be thought  of
  310.           general directions, such as North, South, etc. Usually the inter-
  311.           LAN boundary  is obvious, all you have to do is decide what route
  312.           through your  switches you  want this  foreign traffic to follow.
  313.           This route  is a  good candidate  for a  backbone  channel  on  a
  314.           different band.
  315.  
  316.                When each of these items is defined, you will have completed
  317.           a basic  network design.   The  method is  minimal, but  it  will
  318.           assist you  in understanding the workings of the network when you
  319.           start the  deployment phase.  It will also be helpful when trying
  320.           to debug network problems.
  321.  
  322.      Network Configuration     Network Configuration
  323.  
  324.                In a ROSE X.25 Network each switch has a description of what
  325.           the network  looks like from it's point of view. This consists of
  326.           a list  of  switches  that  it  talks  to  directly  and  routing
  327.           information.  The  routing  information  describes  what  network
  328.           addresses each  of the  switches in  the list  can handle. When a
  329.           connect request is received by a switch it must be able to decide
  330.           where the request should be sent next. Connection requests can be
  331.           from either a local user or from another switch.
  332.  
  333.                The configuration  of a  switch is  stored in  a  file  that
  334.           contains four sections. These are:
  335.  
  336.                1) Default Parameters
  337.                2) Information about the switch being configured
  338.                3) A list of switches local to the switch being configured
  339.                4) Routing information, who should handle what addresses
  340.  
  341.                Appendix 4  contains a list of terms that should be reviewed
  342.           to aid in clarity of the descriptions.
  343.  
  344.  
  345.                                                                         5
  346.  
  347.  
  348.                Default Parameters               Default Parameters
  349.  
  350.                There are  four switch parameters that can be defaulted, the
  351.           form of the default command is:
  352.  
  353.                DEFAULT par Value
  354.  
  355.                Where the  "par" is one of the following and the value is as
  356.           described.
  357.  
  358.                L3W 1..7               L3W 1..7
  359.  
  360.                This  configures  the  Level  3  Packet  Window,  much  like
  361.           MAXFRAME for TNC Links.  As noted valid values are 1 through 7.
  362.  
  363.                TimeOut 0..65535               TimeOut 0..65535
  364.  
  365.                When a  network Link  is not  operational  due  to  a  radio
  366.           failure or  interference a  timer is  started to  keep the switch
  367.           from continuously  trying to  bring up  the link. This is done to
  368.           reduce the  time required to route around a malfunctioning switch
  369.           or path.  The suggested  value is  900 seconds  (15 Minutes), but
  370.           other values  can be  used from  0 to 65535 seconds (18 Hours). A
  371.           realistic minimum value is 3-5 minutes. A lower value could cause
  372.           the call  router to  try a  bad link more than once with the same
  373.           call request.
  374.  
  375.                MaxVC 0..254               MaxVC 0..254
  376.  
  377.                This parameter  sets the  number  of  VCs,  or  simultaneous                                                     ___                   
  378.           connections, that  will be  allowed on  a Link to another switch.
  379.           The recommended  value for this is 20. A special case occurs when
  380.           this statement appears in a USER block statement.
  381.  
  382.                Port 0..4               Port 0..4
  383.  
  384.                This defines  which serial  port on  the switch  the Node or
  385.           User is  said to be listening. On a TNC-2 the radio is Port 0 and
  386.           the RS-232 connector is Port 1.
  387.  
  388.                The recommended values for these defaults are:
  389.  
  390.                DEFAULT PORT 0
  391.                DEFAULT TIMEOUT 900
  392.                DEFAULT L3W 4
  393.                DEFAULT MAXVC 20
  394.  
  395.                Include               Include
  396.  
  397.                This  default   parameter  defines   a  directory  that  the
  398.           configuration program  will check  for include  files (*<).  This
  399.           directory is  only checked  if the  included file is not found in
  400.           the current directory.
  401.  
  402.  
  403.                                                                         6
  404.  
  405.  
  406.                DEFAULT Include C:\ROSENET\
  407.  
  408.                Password Protection               Password Protection
  409.  
  410.                To protect  the switch  from being  accessed by unauthorized
  411.           users  the   application  loader  has  password  protection.  The
  412.           password is  contained in an external file that is in the current
  413.           directory or the Default Include directory. The password file has
  414.           two parts,  first is  a decimal  number indicating  how long  the
  415.           correct reply should be and the second part is the password key.
  416.  
  417.                For Example:
  418.  
  419.                1
  420.                ROSEISBESTABCDEFGHIJKLMNOPQRSTUVWXYZ
  421.  
  422.                When you  connect to  LOADER you  will be  presented with  a
  423.           series of 16 hex numbers.
  424.  
  425.                Example:
  426.  
  427.                cmd:C LOADER Via ROSE-3,000000                   __________________________
  428.                *** CONNECTED TO LOADER VIA ROSE-3,000000
  429.                Call being setup               Call being setup
  430.                Call Completed to LOADER @ 3100000000               Call Completed to LOADER @ 3100000000
  431.                ROSE X.25 Packet Switch Version 901026 by Thomas A. Moulton,               ROSE X.25 Packet Switch Version 901026 by Thomas A. Moulton,
  432.           W2VY          W2VY
  433.                03 04 1D 22 05 10 19 08 1A 11 18 02 09 01 20 1F               03 04 1D 22 05 10 19 08 1A 11 18 02 09 01 20 1F
  434.                E               _
  435.                OK               OK
  436.  
  437.                Since the reply length is one, you only need to reply to the
  438.           first number.  It is  important to  note that the first character
  439.           (the "R"  of ROSE  in this  case) is counted as 00. Therefore the
  440.           correct reply  is "E".  If the reply length is configured as zero
  441.           (0) then no password is required.
  442.  
  443.                The default  is to  have  No  password.  The  supplied  file
  444.           (PASSWORD.RS) has the example given above as a sample. A password
  445.           will also  be configurable  in the  EPROM in  future releases  of
  446.           MAKEPROM.EXE.
  447.  
  448.                A handy  utility to  print a table for reply key look up can
  449.           be made using ROSEPWD.EXE. See the description of it for details.
  450.  
  451.                Information about the switch being configured               Information about the switch being configured
  452.  
  453.                The first  thing that  must be done is a declaration of what
  454.           country this  switch is  in.  This is done with the DNIC command,
  455.           which has the form:
  456.  
  457.                THIS DNIC 3100 United States of America
  458.  
  459.  
  460.                                                                         7
  461.  
  462.  
  463.                The THIS  command is used on the beginning of a statement to
  464.           identify that  the rest  of the  line is  for the  switch that is
  465.           being configured.
  466.  
  467.                The 3100  is the  country code  for the  USA within the data
  468.           networks. A  complete list of DNICs can be found in Appendix C of
  469.           the ROSE  X.25 Packet Switch Users Manual, which is in Appendix 2
  470.           of this manual.
  471.  
  472.                Once this  is done  you can  define the internal information
  473.           about the  switch being  configured. Again we use the THIS prefix
  474.           to identify we are talking about the switch being configured.
  475.  
  476.                THIS NODE Clifton
  477.  
  478.                The NODE  statement is  a Block Statement that is terminated
  479.           with an END statement.
  480.  
  481.                Note: The  location name, Clifton in this case, is only used
  482.           within the configuration file, not on the air. This name must not
  483.           have any  spaces or  commas in  it. Little Falls, NJ is listed as
  484.           LittleFalls.
  485.  
  486.                Each switch  must have  a Network  Address, this  is what is
  487.           used to reference the switch as the destination of a Call Request
  488.           from anywhere in the network.
  489.  
  490.                ADDRESS 201478
  491.  
  492.                The address  can be  from 1 to 6 digits long and must follow
  493.           the national  numbering plan  in use for the X.25 network. In the
  494.           United States  of America  this must  be the  Area Code and local
  495.           Exchange of the location of the switch.
  496.  
  497.                In order  for users and other switches to establish Links to
  498.           this switch it must have an Amateur callsign.
  499.  
  500.                CALL W2VY-3
  501.  
  502.                CALL is  short for  CALLSIGN in this case. The EPROM default
  503.           for the  callsign is  ROSE-3. When  this  callsign  is  used  for
  504.           switching requests, all network level messages will be displayed.
  505.           These messages  include connection setup status, and notification
  506.           reset conditions that could have lost some information.
  507.  
  508.                Each switch  also has  a  callsign  that  can  be  used  for
  509.           digipeating, this  may be  the same  as  the  CALL.  The  default
  510.           digipeat callsign  is ROSE-2.  If the  CALL and DIGI are the same
  511.           they both still need to be specified. If a switching request uses
  512.           this callsign  there will  be no  additional messages inserted by
  513.           the network  during data transfer, if there is a chance that data
  514.           was lost  due to  a reset  the connection  will be cleared. It is
  515.           strongly  suggested  that  BBS  forwarding  use  this  method  of
  516.  
  517.  
  518.                                                                         8
  519.  
  520.  
  521.           establishing connections.  If the  CALL and  DIGI  are  the  same
  522.           callsign, the messages will always be disabled.
  523.  
  524.                DIGI W2VY-2
  525.  
  526.                If a  switch has  a RF  coverage that  crosses more than one
  527.           telephone exchange then these extra exchanges can be specified in
  528.           the  COVERAGE  statement.  This  is  a  Block  Statement  and  is
  529.           terminated with  an END.  This is  an example  of a  nested block
  530.           statement, we are still in the "This Node Clifton" Block.
  531.  
  532.                COVERAGE
  533.                201472 201473 201777 201779 201470 201478
  534.                201778 201772
  535.                END
  536.  
  537.                Each of  the Network  Addresses listed above will be treated
  538.           as if they were the switch Network Address, 201478 in this case.
  539.  
  540.                When a  Call Request is received that has this switch as the
  541.           destination, address  201478 or  one in  the Coverage  list,  the
  542.           switch will  attempt to establish a Link with the specified user.
  543.           If the  switch is  running on  multi-port  hardware,  such  as  a
  544.           PacComm DR-200  there are  times when  you need  to specify which
  545.           Port the  users are resident on. The USERPORT statement specifies
  546.           which Port should be used to establish Links to users. On a TNC-2
  547.           the Radio  port is  port 0. On a PacComm DR-100 the radio port is
  548.           port 1.
  549.  
  550.                USERPORT 0
  551.  
  552.                A user  can connect  to the switch and get information about
  553.           how to use the network, or other information of general interest.
  554.           This is  specified in a TEXT block, which is ended with "$EOF". A
  555.           blank line is inserted by having a "$" on a line by itself.
  556.  
  557.           TEXT
  558.           $
  559.           While Disconnected From THIS X.25 Switch issue a command like:
  560.           $
  561.           C CALLSIGN-SSID V W2VY-3,201256
  562.           $
  563.                        Switches Available for User Access are:
  564.                Address   Callsign   Location             User Port Freq
  565.                 201256   W2VY-3     Montclair              221.11 Mhz
  566.                 201744   N2DSY-3    LittleFalls,NJ         145.07 Mhz
  567.                 609426   KA2VLP-3   Hightstown,NJ          145.07 Mhz
  568.                 609261   WA3YRI-3   MtHolly,NJ             145.07 Mhz
  569.                 212456   KD6TH-6    Manhattan,NY           145.07 Mhz
  570.                 609530   N2EVW-9    Ewing,NJ               221.01 Mhz
  571.                 609883   N2EVW-8    Trenton,NJ             221.11 Mhz
  572.                 201663   N2ELC-3    Lake Hopatcong,NJ       145.09 Mhz
  573.           $
  574.           Possible connect paths available to access BBS User ports.
  575.  
  576.  
  577.                                                                         9
  578.  
  579.  
  580.           C KB1BD-4 V W2VY-3,609426   :   C WA2VXT-4 v W2VY-3,609426
  581.           C KD6TH-4 V W2VY-3,201744   :   C N2ELC-4 v W2VY-3,201663
  582.           $
  583.           Connect Paths Available to KA-Nodes or TheNET Facilities:
  584.           C WB2DRD-3 V W2VY-3,609426  :   C WB2MNF-3 V W2VY-3,609530
  585.           $
  586.           When connecting  to TheNet  Nodes act  as if  you have  connected
  587.           direct to  it.   Type C  NODENAME, after  you have  connected  to
  588.           either of  the TheNet  nodes listed above, to connect to the next
  589.           desired node. Type NODES to get a node list after your connect or
  590.           type Info to get information about the particular TheNet node you
  591.           are connected to. Example:  To connect to ELK TheNet node use the
  592.           following sequence:
  593.           C WB2DRD-3 V W2VY-3,6o9530
  594.           C ELK
  595.           $
  596.           You will  shortly be  Disconnected from  this switch.  If you are
  597.           currently connected  via either  TheNET or  KA-Node RECONNECT  to
  598.           THAT node  and then issue a connect as shown above.  Note: It has
  599.           come to our attention that those systems using old TNC1 code will
  600.           not accept  all digit  fields, substitute  o for 0 and i for 1 in
  601.           the all digit field and you will be successful.  Disconnect codes
  602.           can be  found on the KB1BD-4 PBBS, filename is DISCO.COD.  Please
  603.           address questions  to  KB1BD@KB1BD  or  W2VY@KD6TH.  This  switch
  604.           brought to you courtesy of RATS.  Enjoy 73 Tom W2VY
  605.           $EOF
  606.  
  607.                This connect TEXT can be up to 2048 bytes long.
  608.  
  609.                To terminate  the definition  of the  Clifton Node  the  END
  610.           statement is used, completing the block statement.
  611.  
  612.                END
  613.  
  614.                Local Switches               Local Switches
  615.  
  616.                The next  section describes  the switches  that this  switch
  617.           communicates with directly.
  618.  
  619.                NODE Manhattan
  620.                ADDRESS 212456
  621.                PATH KD6TH-3
  622.                END
  623.  
  624.                This defines  a local  switch that  has the callsign KD6TH-3
  625.           and network  address 212456 and is located in Manhattan. Based on
  626.           the current  defaults it is also on PORT 0 with a link timeout of
  627.           15 Minutes and can support up to 20 calls. Each call will operate
  628.           with a level 3 packet window of 4.
  629.  
  630.                For the  purposes of  this description  we will  also define
  631.           three other local switches.
  632.  
  633.                NODE LittleFalls
  634.  
  635.  
  636.                                                                         10
  637.  
  638.  
  639.                ADDRESS 201744
  640.                PATH N2DSY-3
  641.                END
  642.  
  643.                NODE Clifton2
  644.                ADDRESS 201779
  645.                PATH W2VY-9
  646.                PORT 1
  647.                END
  648.  
  649.                NODE Montclair
  650.                ADDRESS 201256
  651.                PATH W2VY-12 Via KB1BD-2
  652.                END
  653.  
  654.                Each  of  these  are  pretty  standard  with  the  following
  655.           exceptions.     Clifton2  is  on  PORT  1,  which  would  be  the
  656.           asynchronous port  if we  are running  on a  TNC-2 and  that port
  657.           could be  connected to either a modem and radio or a back to back
  658.           cable to  another TNC.  Montclair has a digipeater specified, the
  659.           path to a switch can include up to ONE digipeater.
  660.  
  661.                If you  have a  special device  that is  not on the USERPORT
  662.           channel you  can configure  it in  the switch  as a USER. If this
  663.           USER is not an X.25 Pad (ie it's a TNC or TheNet/NetROM) you must
  664.           specify MAXVC 0.
  665.  
  666.                USER KD6THbbs
  667.                PATH KD6TH-4
  668.                PORT 1
  669.                MAXVC 0
  670.                END
  671.  
  672.                If a  call came  in for  KD6TH-4 with  a switch  address  of
  673.           201478 the  switch would attempt to establish the link on Port 1,
  674.           as was specified. This can be done for any AX25L2 device, such as
  675.           a TheNet or NetROM, as well as a BBS. Users are not encouraged to
  676.           be placed  on the  backbone. If  using a  TNC-2  you  would  just
  677.           specify the  address of the switch that had the radio port on the
  678.           backbone. This  feature is used mostly when the switch is running
  679.           a PacComm DR-200, or other multi-port synchronous device.
  680.  
  681.                Routing Information               Routing Information
  682.  
  683.                The route  statements specify  what local switches should be
  684.           given calls for which network addresses.  This is usually divided
  685.           into two  parts, first  specifying the  routing  needed  for  the
  686.           switches within  the local network (the switches you control) and
  687.           the second  specifying  the  routing  for  out  of  area  network
  688.           addresses.
  689.  
  690.  
  691.                                                                         11
  692.  
  693.  
  694.                The general form of the ROUTE statement is:
  695.  
  696.                ROUTE TO NODES node-list
  697.                CALLS FOR
  698.                network-address-list
  699.                END
  700.  
  701.                Where "node-list"  is a  sequence of switches; and "network-
  702.           address-list" is a list of Network Addresses. The network address
  703.           is  composed   of  the  current  DNIC  followed  by  the  address
  704.           specified. If  the command  "DNIC 0"  is entered then there is no
  705.           DNIC added  to the  address, this  is useful  to route  an entire
  706.           country or continent.
  707.  
  708.                If a  Call Request  is received  for one of the addresses in
  709.           the list the switch will use this routing information to pass the
  710.           Call to the next switch. The switches are tried in the order they
  711.           are listed, so the best route should be listed first, worse last.
  712.           It has  been done  this way  because by  and large  there  are  a
  713.           limited number  of ways  to get  from this  switch  to  a  remote
  714.           region. From the Clifton switch I can route calls for New England
  715.           to Manhattan  or Little  Falls, so  the following statement would
  716.           set up the required routing entries.
  717.  
  718.                Route to Nodes Manhattan LittleFalls
  719.                Calls for
  720.                207 802 617 508 413 203 401
  721.                518 607 212 718 716 516 914 315
  722.                end
  723.  
  724.                I also included the Area Codes for New York.
  725.  
  726.                We also  need to  include the routes for the local switches.
  727.           The routing  information here  should include the address of each
  728.           switch as well as the addresses in it's coverage.
  729.  
  730.                Route to Node Manhattan
  731.                Calls for
  732.                212456
  733.                end
  734.  
  735.                Route to Node LittleFalls
  736.                Calls for
  737.                201744
  738.                end
  739.  
  740.                As well as addresses to the south and west:
  741.  
  742.                Route to Node LittleFalls
  743.                Calls for
  744.                609 215 717 202
  745.                end
  746.  
  747.  
  748.                                                                         12
  749.  
  750.  
  751.                There are files included with the distribution diskette that
  752.           have the Area Codes for the entire USA,  broken down by state and
  753.           call district,  see NPA.ARC.  These files  can  be  placed  in  a
  754.           separate directory  and included in the configuration with the *<
  755.           command.
  756.  
  757.                To include  routing information for other countries you will
  758.           need to  add routing  information for their DNIC's. To facilitate
  759.           this you can have a command such as;
  760.  
  761.                DNIC 0               DNIC 0
  762.  
  763.                Which will allow routing statements to include the DNIC;
  764.  
  765.                Route to Nodes LittleFalls Manhattan               Route to Nodes LittleFalls Manhattan
  766.                Calls for               Calls for
  767.                3020 7               3020 7
  768.                end               end
  769.  
  770.                This will  add routing  information for all calls to Canada,
  771.           which is  DNIC 3020,  as well  as South  America, where all DNICs
  772.           start with a 7.
  773.  
  774.                Now that  we have  defined the  configuration of a switch we
  775.           need to  create, and  save to  disk, the file that the switch can
  776.           understand. The WRITE statement is used to create this file.
  777.  
  778.                WRITE w2vy-3.tbl
  779.  
  780.                The file  naming conventions  that we use here in NJ are the
  781.           statements that  were used  in the  example are  stored in a file
  782.           with the  name CallSign.CNF  and the output is stored in the file
  783.           CallSign.TBL. (".CNF" Configuration; ".TBL" Table)
  784.  
  785.                The last  statement of  each .CNF  file should  be a QUIT to
  786.           tell the  configuration program  to terminate  and return  to the
  787.           operating system.
  788.  
  789.      Additional Configuration Commands     Additional Configuration Commands
  790.  
  791.                If you  are having problems figuring out an error, it can be
  792.           helpful to  see the commands that the program is reading. You can
  793.           cause the  configuration program  to print  each statement  as it
  794.           reads it in by including a VERIFY statement.
  795.  
  796.                VERIFY
  797.                ... statements causing problems...
  798.                NOVERIFY
  799.  
  800.                The NOVERIFY  statement turns this feature off, there can be
  801.           any number of VERIFY/NOVERIFY statements in a configuration file.
  802.  
  803.  
  804.                                                                         13
  805.  
  806.  
  807.      Special Characters to the Configuration Program     Special Characters to the Configuration Program
  808.  
  809.                Any line  in the  configuration file (.CNF) that starts with
  810.           an asterisk  (*) is  treated as a comment, which can be useful to
  811.           indicate extra  information about  a switch, such as equipment at
  812.           the location, access rules, failure history, etc.
  813.  
  814.                There is  one exception,  if a  line starts  with  "*<"  the
  815.           configuration program will treat the text on the rest of the line
  816.           as a  file name.  The program  will expect  the file to be in the
  817.           current directory  or the  directory  specified  in  the  Default                                                                    Default
  818.           Include statement. The contents of the file will be read in as if          Include                                                          
  819.           it had  been in  the main file. If the file is not found an error
  820.           message will be printed.
  821.  
  822.                The file  that is being read in can not have another "*<" in
  823.           it, this  may be  revised in  later versions of the configuration
  824.           program.
  825.  
  826.                Route to Nodes Manhattan LittleFalls
  827.                Calls for
  828.                *<w1.npa
  829.                *<ny.npa
  830.                end
  831.  
  832.                This would  be the  same as  the previous example of routing
  833.           the calls  for New England and New York, using the supplied files
  834.           in NPA.ARC.
  835.  
  836.      ROSE X.25 Packet Switch Applications     ROSE X.25 Packet Switch Applications
  837.  
  838.                A  Switch   Application  is   a  special   type  of  network
  839.           destination, like  a BBS  is a  special callsign that you connect
  840.           to. Once  connected to it you can issue commands and get replies.
  841.           The following  sections describe  the existing  applications  and
  842.           list any commands and example replies.
  843.  
  844.                To connect to a switch application you would follow the same
  845.           procedure that  you would  to connect  to a  user, but instead of
  846.           entering a user's callsign you enter the name of the application.
  847.           If your  local switch is W2VY-3 and you want to interact with the
  848.           MEMSIZ application at network address 201478, you would issue the
  849.           following connect command:
  850.  
  851.                C MEMSIZ Via W2VY-3,201478
  852.  
  853.                This is  a standard ROSE X.25 Packet Switch connect request.
  854.           The local  switch would route the Call Request to the switch with
  855.           the network address 201478. When a switch receives a Call Request
  856.           it first  checks to see if the destination "callsign" matches any
  857.           of the currently loaded applications. If the application is found
  858.           the switch  would set  up connection with the application. If the
  859.           application was  not loaded  it would  assume that it was a local
  860.           user and attempt a connect on the userport.
  861.  
  862.  
  863.                                                                         14
  864.  
  865.  
  866.                Once connected  to the  MEMSIZ application you would get the
  867.           ROSE banner:
  868.  
  869.           ROSE X.25 Switch Version 890820 by Thomas A. Moulton, W2VY
  870.  
  871.                This would  indicate that the connection is complete and you
  872.           could start interacting with that switch.
  873.  
  874.                The applications  that  accept  commands  currently  use  an
  875.           obscure format that has the general form:
  876.  
  877.                :ccoollll[dd]xx
  878.  
  879.                Where:
  880.  
  881.                cc   is a command number
  882.                00   is an object number
  883.                llll is the length of any optional data
  884.                dd   is the data if the length is non-zero
  885.                xx   is the checksum of the data field
  886.  
  887.                The only  applications that  support data  fields are LOADER
  888.           and CONFIG.  The commands for these are generally stored in files
  889.           created  by   programs  such   as  the   configuration   compiler
  890.           (CONFIGUR.EXE).   All other  commands are  simply single commands
  891.           that end  with  six  zeros.    These  will  be  listed  with  the
  892.           description  of   each  application.  In  future  releases  these
  893.           commands will  be replaced with easier to remember plain language
  894.           commands.
  895.  
  896.      LOADER Application     LOADER Application
  897.  
  898.                The LOADER application is resident in the EPROM, this means
  899.           it is always present. As you may be able to guess from the name,
  900.           it is used to load other programs into the switch. This will
  901.           allow you to chose which switches will have what functions.
  902.  
  903.                The files with the filename extension ".LOD" are files that
  904.           can be sent to this application, which will cause the specific
  905.           application to be loaded into memory. The file "CONFIG.LOD" when
  906.           sent (ASCII/TEXT upload) to LOADER would cause the CONFIG
  907.           application to be loaded into memory.
  908.  
  909.                When loading a .LOD file you should get three "OK"'s back,
  910.           the only other message you could get would be "Error n" where N
  911.           is a numeric value indicating what type of error occurred, the
  912.           following table lists the possible error numbers.
  913.  
  914.                Error #   Meaning               _________________
  915.                01        Invalid command
  916.                02        Invalid Object
  917.                03        Unable to allocate memory for program
  918.                04        Incorrect checksum
  919.                09        Length mismatch of code segment in .LOD file
  920.  
  921.  
  922.                                                                         15
  923.  
  924.  
  925.                0C        Can't delete non-existent application
  926.                0D        Need to load code segment before relocation info
  927.                0E        To many applications loaded, max is 15
  928.                0F        Unsupported object
  929.                10        Unsupported command
  930.  
  931.                LOADER also supports two other commands:
  932.  
  933.                List Applications ":0000000000"
  934.  
  935.                This command will cause the switch to list all the
  936.           applications that are currently loaded into the memory. When the
  937.           switch is first powered on the list will look like this:
  938.  
  939.                Entry #0 LOADER - Application Boot interface               Entry #0 LOADER - Application Boot interface
  940.                OK               OK
  941.  
  942.                If the switch has all the applications loaded into memory
  943.           then the list might look like this:
  944.  
  945.           Entry #0 LOADER - Application Boot interface          Entry #0 LOADER - Application Boot interface
  946.           Entry #1 CONFIG - ROSE X.25 Packet Switch Configuration Interf...          Entry #1 CONFIG - ROSE X.25 Packet Switch Configuration Interf...
  947.           Entry #2 USERS  - ROSE Switch User List Display, Version 1.0          Entry #2 USERS  - ROSE Switch User List Display, Version 1.0
  948.           Entry #3 MEMSIZ - ROSE Memory Utilization Display          Entry #3 MEMSIZ - ROSE Memory Utilization Display
  949.           OK          OK
  950.  
  951.                The entry # is just the position in the list that the
  952.           application is listed, this number is only important when you are
  953.           using the Delete command.
  954.  
  955.                Delete Application ":02ee000000"
  956.  
  957.                This command will remove an application from memory, thus
  958.           freeing the memory to be used for other things such as data
  959.           buffers or additional connections. The "ee" is the entry number
  960.           the application is in the list.
  961.  
  962.                Lets say you want to delete the CONFIG application from a
  963.           switch, first you would connect to the LOADER and then list the
  964.           applications:
  965.  
  966.           :0000000000          ___________
  967.           Entry #0 LOADER - Application Boot interface          Entry #0 LOADER - Application Boot interface
  968.           Entry #1 CONFIG - ROSE X.25 Packet Switch Configuration Interf...          Entry #1 CONFIG - ROSE X.25 Packet Switch Configuration Interf...
  969.           Entry #2 USERS  - ROSE Switch User List Display, Version 1.0          Entry #2 USERS  - ROSE Switch User List Display, Version 1.0
  970.           Entry #3 MEMSIZ - ROSE Memory Utilization Display          Entry #3 MEMSIZ - ROSE Memory Utilization Display
  971.           OK          OK
  972.  
  973.                Notice that the CONFIG application is in entry #1 this time,
  974.           you would enter the following command, replacing the "ee" with
  975.           "01".
  976.  
  977.           :0201000000          ___________
  978.           OK          OK
  979.  
  980.  
  981.                                                                         16
  982.  
  983.  
  984.                You could then verify that it was done by entering the list
  985.           command again. The "OK" does tell you that it was in fact done,
  986.           but we'll check anyway, you don't have to check.
  987.  
  988.           :0000000000          ___________
  989.           Entry #0 LOADER - Application Boot interface          Entry #0 LOADER - Application Boot interface
  990.           Entry #1 USERS  - ROSE Switch User List Display, Version 1.0          Entry #1 USERS  - ROSE Switch User List Display, Version 1.0
  991.           Entry #2 MEMSIZ - ROSE Memory Utilization Display          Entry #2 MEMSIZ - ROSE Memory Utilization Display
  992.           OK          OK
  993.  
  994.                Note that all other applications moved up in the application
  995.           list.
  996.  
  997.                When you are done interacting with the LOADER you just
  998.           disconnect.
  999.  
  1000.                In addition to accepting the commands described and the
  1001.           ".LOD" files, the LOADER will also accept a ".TBL" file. When a
  1002.           .TBL file is sent to the LOADER the only item that will get
  1003.           updated is the INFO Text (Connect TEXT). You will receive 10
  1004.           "Error 000F" messages and one OK, this is the correct response to
  1005.           a .TBL file and the Error's will not cause any problems. If you
  1006.           do not like getting the "Error 000F" messages you can edit the
  1007.           ".TBL" file and just send the text load command. To do this just
  1008.           take from the ":0100" to the end of the file and store it in a
  1009.           separate file. This was done because the Connect Text is the only
  1010.           configurable information that is not saved in battery backed up
  1011.           memory and allows easy restoration of that information.
  1012.  
  1013.      LOADABLE APPLICATIONS     LOADABLE APPLICATIONS
  1014.  
  1015.                The ROSE  X.25 Packet  Switch EPROM  has  been  designed  to
  1016.           maintain all  functions necessary for packet switching within the
  1017.           ROSE EPROM.  In order to provide for the various User and Network
  1018.           Manager interfaces  and functions  the EPROM  can accept programs
  1019.           loaded  through  the  network.  A  description  of  the  existing
  1020.           applications can be found in the following sections.
  1021.  
  1022.      BOOTER Application     BOOTER Application
  1023.  
  1024.                The BOOTER  Application can  be used to fake a power failure
  1025.           on a  remote switch.  The switch  will be initialized immediately
  1026.           upon receiving the BOOTER.LOD file. When the file has been loaded
  1027.           into the  switch you will get a "*** Disconnect *** 00E9" or some
  1028.           other abnormal  termination. This  action will  indicate that the
  1029.           switch  was   re-initialize,   it   should   maintain   all   the
  1030.           configuration information. It should act as if the power had been
  1031.           removed.
  1032.  
  1033.      CONFIG Application     CONFIG Application
  1034.  
  1035.                The CONFIG  application is  not designed to be used directly
  1036.           by the switch manager. It is just an interface that processes the
  1037.           file created by the Network Configuration Program (CONFIGUR.EXE).
  1038.  
  1039.  
  1040.                                                                         17
  1041.  
  1042.  
  1043.           This section  will describe  the interface  for completeness, and
  1044.           there may  be times  when you  might want  to check  some of  the
  1045.           settings.   All replies  are in  hexadecimal and  are not easy to
  1046.           interpret. As  with  the  LOADER  interface  every  command  will
  1047.           generate either  an "OK"  or "Error n" when the processing of the
  1048.           command is  complete, the  meaning of  each of  the errors are as
  1049.           follows:
  1050.  
  1051.                Error #   Meaning               _________________
  1052.                01        Invalid command
  1053.                02        Invalid Object specified
  1054.                03        No working memory!
  1055.                04        Bad checksum!
  1056.                05        Unsupported Command
  1057.                06        Odd number of data bytes for type
  1058.                07        Item is Read-Only
  1059.  
  1060.                For 0D object only:
  1061.                01        No working memory
  1062.                02        Invalid DNIC
  1063.  
  1064.                The commands have the same format as the LOADER commands.
  1065.  
  1066.                The following commands are currently supported:
  1067.  
  1068.                #    Function
  1069.                01*  Write new information for object
  1070.                02   Read current value of object
  1071.                
  1072.                NOTE: IT IS NOT RECOMMENDED THAT USERS USE THE 01 COMMAND!
  1073.  
  1074.                The following data objects are supported:
  1075.  
  1076.           00   This object contains the TEXT that a user can access if they
  1077.                connect directly to the switch and hit return.
  1078.  
  1079.           01   This is the list of callsigns of other switches and special
  1080.                users configured via the PATH statement Node and User
  1081.                configuration blocks. It also contains the CALL of this
  1082.                switch.
  1083.  
  1084.           02   These are digipeater callsigns that optionally appeared in
  1085.                the "via" field of the PATH statement of Node and User
  1086.                configuration blocks. It also contains the DIGI callsign of
  1087.                this switch.
  1088.  
  1089.           03   These are the PORT numbers of the Node and User
  1090.                configuration blocks.
  1091.  
  1092.           04   These are the MAXVC limits specified in the Node and User
  1093.                configuration blocks. This limits the number of simultaneous
  1094.                network connections that can occur between the this switch
  1095.                and the switch of the Node configuration block. This is also
  1096.                used in the User configuration block to indicate that it is
  1097.  
  1098.  
  1099.                                                                         18
  1100.  
  1101.  
  1102.                a local AX25L2 user, and when found in a User block must be
  1103.                0.
  1104.  
  1105.           05   These set the L3W for the connections going through a
  1106.                network link, valid values are 1-7.
  1107.  
  1108.           06   These set the TIMEOUT value for a failed network link. This
  1109.                is the time it will be considered Out of Order when it
  1110.                fails, ie it gets a "Retry count exceeded".
  1111.  
  1112.           07   This sets the USERPORT which is used for connecting to
  1113.                AX25L2 users, this can be overridden by User configuration
  1114.                blocks.
  1115.  
  1116.           08   This contains the node address of this switch.
  1117.  
  1118.           09*  This contains the default level 2 parameters for AX25L2
  1119.                connections. (Maxframe, Paclen, Resptime, Frack, Retry)
  1120.  
  1121.           0A*  This contains the default level 2 parameters for X.25
  1122.                Network links.
  1123.  
  1124.           * -  In some versions it produces a pointer to the structure.
  1125.  
  1126.           0B   This object is used in conjunction with the routing tables.
  1127.                This contains a compressed set of routing alternatives,
  1128.                since by and large the various routes and back-up routes are
  1129.                common for getting out of the local network.
  1130.  
  1131.           0C   This contains the routing tables for all the DNICs.
  1132.  
  1133.      HEARD Application     HEARD Application
  1134.  
  1135.                The HEARD  application gives  a very complete summary of the
  1136.           activity within  the network.  It started out as a simple listing
  1137.           of stations  heard and  then developed  into an important tool in
  1138.           monitoring network activity.
  1139.  
  1140.                It provides the following information:
  1141.  
  1142.                * Source and Destination Callsigns
  1143.                * Full AX.25 Path
  1144.                * Count of valid frames heard
  1145.                * Frame Type of last frame heard
  1146.                * Time since the last frame was heard
  1147.                * Time since the station was first heard
  1148.  
  1149.  
  1150.                                                                         19
  1151.  
  1152.  
  1153.                A typical display:
  1154.  
  1155.           ROSE X.25 Packet Switch Version 901026 by Thomas A. Moulton, W2VY
  1156.           
  1157.           Heard List for W2VY-9  3100813989
  1158.                                      Last   First (How long ago)
  1159.           Port Station   Destination Heard  Heard  RXCnt FType Path
  1160.             0  W2VY      HEARD       00:00  00:00      4   I   W2VY-9,813989
  1161.             0  K0ZXF     TPALAN      00:00  28:38    117  UI   USF*
  1162.             0  W4DPH     MAIL        00:03  05:55     17  UI
  1163.             0  W4DPH-4   NODES       00:04  03:59      5  UI
  1164.             0  KC2FF-7   ID          00:07  73:25    443  UI
  1165.             0  KC2FF-7   NODES       00:09  03:07     24  UI
  1166.             0  W4DPH-15  W2VY        00:09  01:09     16 SABM
  1167.             0  W4DPH-4   ID          00:13  74:48    345  UI
  1168.             0  W8DUW     TPALAN      00:16  03:39     14  UI   USF*
  1169.             0  N4OJU-6   K0ZXF       00:36  03:35     24 DISC
  1170.             0  CLW5      KB4VHS-15   00:58  01:23     17  UA
  1171.             0  KB4VHS    DABQSO      00:59  01:00      5 SABM  N4EEB-5,904677
  1172.             0  KB4VHS    KB4T        01:01  01:03      5 SABM  N4EEB5,904677
  1173.             0  N4HKA     WA1GUD      01:03  02:08    100  UA
  1174.             0  WA1GUD    N4HKA       01:03  02:08    109 DISC
  1175.           END>
  1176.                
  1177.  
  1178.                Once connected  to HEARD just hit return and it will provide
  1179.           a screen  full of  heard stations. For a longer display enter "*"
  1180.           followed by return and it will list 32 entries.
  1181.  
  1182.      INFO Applications     INFO Applications
  1183.  
  1184.                The INFO Application can be used to display the connect text
  1185.           of a  remote switch. The text is the same that would be displayed
  1186.           if you  were to  connect directly  to the  switch and hit return.
  1187.           This application also adds text messages to the *** Reset *** and
  1188.           ***  Disconnect   ***  network  messages  that  give  an  english
  1189.           description of the reason for the message.
  1190.  
  1191.                There are  also other  versions of  the INFO  Application to
  1192.           provide Reset  and Disconnect  messages from other languages. The
  1193.           ".LOD" files will have names in the following format:
  1194.  
  1195.                INFO??.LOD
  1196.  
  1197.                Where the ?? denoted the language
  1198.  
  1199.                SP - Spanish
  1200.                DE - German
  1201.                FR - French*
  1202.                RU - Russian*
  1203.  
  1204.                * - In progress - Not yet supplied in the ZIP archive.
  1205.  
  1206.  
  1207.                                                                         20
  1208.  
  1209.  
  1210.      MHEARD Application     MHEARD Application
  1211.  
  1212.                The MHEARD  Application is a stripped down version of HEARD.
  1213.           It just shows the callsigns of the heard stations.
  1214.  
  1215.      MEMSIZ Application     MEMSIZ Application
  1216.  
  1217.                The MEMSIZ  application was  just a  test program  for me to
  1218.           verify correct  operation of the loader. It turns out that it can
  1219.           be useful  to monitor  the amount of memory that is being used by
  1220.           the switch  from time  to time. This information is also included
  1221.           in the  USERS application  display.  The  values  are  listed  in
  1222.           hexadecimal.
  1223.  
  1224.           Memory Size is: 7578
  1225.           Memory Used is: 4155
  1226.  
  1227.      USERS Application     USERS Application
  1228.  
  1229.                The USERS  application is  used to  list the  users that are
  1230.           currently using  the  switch;  connected  to  a  local  user/bbs;
  1231.           passing  through  to  another  switch;  or  interacting  with  an
  1232.           application that has been loaded. Once you are connected just hit
  1233.           return to view the current status of the connections.
  1234.  
  1235.           ROSE X.25 Switch Version 890820 by Thomas A. Moulton, W2VY          ROSE X.25 Switch Version 890820 by Thomas A. Moulton, W2VY
  1236.           [You Press Return]
  1237.           
  1238.           User List for N2DSY-3   3100201744          User List for N2DSY-3   3100201744
  1239.           
  1240.           W2VY     AX25L2 User Linked to USERS     @ 3100201744          W2VY     AX25L2 User Linked to USERS     @ 3100201744
  1241.           W2VY     AX25L2 User Linked to LOADER    @ 3100201744          W2VY     AX25L2 User Linked to LOADER    @ 3100201744
  1242.           W2VY-3    X.25 Trunk (R1) with the following connections:          W2VY-3    X.25 Trunk (R1) with the following connections:
  1243.           KD6TH-4   @ 3100201256     ( 20 P4 D1) <-- KB1BD-5   @ 3100609443          KD6TH-4   @ 3100201256     ( 20 P4 D1) <-- KB1BD-5   @ 3100609443
  1244.           WB2JQR-3  X.25 Trunk (R1) with the following connections:          WB2JQR-3  X.25 Trunk (R1) with the following connections:
  1245.           KB1BD-5   @ 3100609443     ( 20 P4 D1) --> KD6TH-4   @ 3100201256          KB1BD-5   @ 3100609443     ( 20 P4 D1) --> KD6TH-4   @ 3100201256
  1246.           
  1247.           There are no calls Pending.          There are no calls Pending.
  1248.           
  1249.           The Following X.25 Trunks are listed as Out of Order:          The Following X.25 Trunks are listed as Out of Order:
  1250.           <None> - All Links Operational          <None> - All Links Operational
  1251.           
  1252.                The first line identifies the callsign and address of the
  1253.           switch that the display is for.
  1254.  
  1255.                The second section shows all active connections. The first
  1256.           connection is my station connected to the USERS application (its
  1257.           how I generated the above display). The second connection is my
  1258.           station connected to the LOADER application. Note that a
  1259.           connection that is listed as "AX25L2 User" is a user directly
  1260.           connected to that switch.
  1261.  
  1262.  
  1263.                                                                         21
  1264.  
  1265.  
  1266.                Now things start to get interesting, W2VY-3 is another ROSE
  1267.           X.25 Packet Switch and it has one VC. The VC is between KB1BD-5
  1268.           at address 609443 and KD6TH-4 at 201256, these are two BBSs doing
  1269.           forwarding.
  1270.  
  1271.                In this case neither BBS is local so the call also shows up
  1272.           on a second X.25 Trunk. The arrow indicates the direction that
  1273.           the connect request went in, ie. KB1BD-5 called KD6TH-4.
  1274.  
  1275.                Note that this connection shows up twice, once to enter the
  1276.           switch and once to leave. If a user was using the switching
  1277.           function to connect to a station on the same switch there would
  1278.           be two entries listed as AX25L2 Users.
  1279.  
  1280.                A pending call is a connect request that came in while the
  1281.           trunk, or link, to the required switch was not ready. A Call is
  1282.           left in the pending state while the Switch attempts to bring the
  1283.           link into the ready state (R1).
  1284.  
  1285.                If a link to a switch is not operational then it is marked
  1286.           as being Out of Order for a specified time (HH:MM:SS).
  1287.  
  1288.       Running ROSEPWD      Running ROSEPWD
  1289.  
  1290.                The ROSEPWD.EXE  program can  be used  to create a table for
  1291.           looking up the correct reply for the password to LOADER.
  1292.  
  1293.                Where file is the name of the password file.                     ____                                  
  1294.  
  1295.                To direct the output to the printer:
  1296.  
  1297.                C>ROSEPWD /H file >prn                 ____________________
  1298.  
  1299.      Running the Configuration Program     Running the Configuration Program
  1300.  
  1301.                You should  run this  program  after  you  have  created  or
  1302.           modified the  configuration file  (.CNF) for a switch. It is used
  1303.           the generate  the file  that gets  uploaded (TEXT/ASCII)  to  the
  1304.           switch CONFIG application, which is described elsewhere.
  1305.  
  1306.                To invoke  the program you insure the program (CONFIGUR.EXE)
  1307.           is in the current directory, or is in the MS-DOS path.
  1308.  
  1309.                C>CONFIGUR w2vy-3.CNF                 ___________________
  1310.                ROSE Interactive Network Monitor by W2VY
  1311.                Largest displacement used = 48
  1312.  
  1313.                Done!
  1314.                C>
  1315.  
  1316.                The message  "Largest Displacement  Used" is  a reference on
  1317.           the size of the routing table and as the routing table grows this
  1318.           number will  change. Any  errors will  be distinctive by starting
  1319.           with "***" with an arrow (^) pointing to the line with the error.
  1320.  
  1321.  
  1322.                                                                         22
  1323.  
  1324.  
  1325.                If you do not specify the input filename (W2VY-3.CNF in this
  1326.           case) or  if the  file you  specified did  not exist, you will be
  1327.           prompted for the file name.
  1328.  
  1329.                C>CONFIGUR                 ________
  1330.                ROSE Interactive Network Monitor by W2VY
  1331.                Node data file name? w2vy-3.cnf                                    __________
  1332.                Largest displacement used = 48
  1333.  
  1334.                Done!
  1335.                C>
  1336.  
  1337.      Configuration Program Command Summary and Error Messages     Configuration Program Command Summary and Error Messages
  1338.  
  1339.                Please ask me for this, I really need to fill this in.
  1340.  
  1341.      Programming the EPROM     Programming the EPROM
  1342.  
  1343.                The files  distributed that  contain Z80 executable have the
  1344.           file extension  ".OVR". The  file "ROSEZSW.OVR" contains the ROSE
  1345.           X.25 Packet  Switch code  and the  other files are initialization
  1346.           routines for the various packet controllers.
  1347.  
  1348.                The MS-DOS  program "MAKEPROM.EXE"  can be  used to create a
  1349.           binary image or Intel Hex file for a specific TNC.
  1350.  
  1351.                If you need to burn an EPROM and do not have access to a MS-
  1352.           DOS machine  see the  note at  the end of this section as well as
  1353.           the following section.
  1354.  
  1355.                The machine models currently supported are:
  1356.  
  1357.                TNC2.OVR   TAPR TNC-2, PacComm TNC-200, Tiny-2, Micropower-2
  1358.                           AEA PK-80, MFJ 1270, 1278 and any TNC-2 Clone
  1359.  
  1360.                DR200.OVR  PacComm DR-200 Dual/DR-100 Single Port Repeater
  1361.  
  1362.                TNC320.OVR PacComm TNC-320 HF Packet Controller
  1363.  
  1364.                PK88.OVR   AEA PK-88 VHF Packet Controller
  1365.  
  1366.                If you  do not  have access to a programmer you can obtain a
  1367.           pre-programmed EPROM from the author.
  1368.  
  1369.                Use the  MAKEPROM.EXE program  to  create  the  file  to  be
  1370.           programmed into  the EPROM.  This program will allow modification
  1371.           of all default parameters, Callsigns, and addresses.
  1372.  
  1373.                Each of  the parameters  is listed on the display and can be
  1374.           modified by  entering the  command followed by the new value. The
  1375.           screen will then be updated to insure that the desired action was
  1376.           taken.
  1377.  
  1378.  
  1379.                                                                         23
  1380.  
  1381.  
  1382.           C>MAKEPROM            MAKEPROM
  1383.  
  1384.           ROSE Z80 X.25 Packet Switch EPROM Creation Program
  1385.           
  1386.           TNC type TNC2.OVR   SWitch ROSEZSW.OVR   OUTput ROSEZSW.BIN
  1387.           output MODE BINary   (BINary | HEX)
  1388.           
  1389.           CALLsign = ROSE-3   DIGIpeat call = ROSE-2   ADDress = 3100000000
  1390.           
  1391.           L2FRack 5   L2RESptime 3   L2CHeck 300   L2RETry 8   L2MAXframe 4
  1392.           L3FRack 5   L3RESptime 2   L3CHeck 600   L3RETry 8   L3MAXframe 3
  1393.           
  1394.                    PORT 0 (5 Pin Din)       PORT 1 (DB25/DE9)
  1395.           
  1396.           TX Delay (0TXDelay)   400 ms.     (1TXDelay)   400 ms.
  1397.           DWait    (0DWait)       0 ms.     (1DWait)       0 ms.
  1398.           FULLdup  (0FULL)      OFF         (1FULL)      OFF
  1399.           
  1400.           Type OK to accept the current settings or,
  1401.           QUIT (all CAPS) to exit to DOS
  1402.           To make changes, type the command followed by the new value
  1403.           Type the portion of the command that is in CAPS.
  1404.           
  1405.           EPROM>
  1406.                
  1407.  
  1408.                All of  the parameters can be specified on the command line,
  1409.           as identified in the following list:
  1410.  
  1411.           C>MAKEPROM /HELP            MAKEPROM /HELP
  1412.  
  1413.           
  1414.           usage:
  1415.            C:\X25\LEVEL3\MAKEPROM.EXE [options]
  1416.           
  1417.           Options are as follows:
  1418.              /HELP        - PRINT THIS LIST!
  1419.              /NODISPLAY   - Supress menu selection screen
  1420.              /MODE=BIN    - Format of OUTput file. See /HEX and /BIN
  1421.              /HEX         - Output file in Intel Hex format
  1422.              /BINary      - Output file in Binary Image format
  1423.              /SWitch=name - Switch Overlay from file name
  1424.              /CALL=ROSE-3 - EPROM Callsign of Switch
  1425.              /DIGI=ROSE-2 - EPROM Digi Callsign
  1426.              /ADDress=3100000000 - X.121 Address of switch
  1427.              /TNC=TNC2    - Machine type, TNC2 | TNC320 | DR200 | PK88
  1428.              /OUTput=name - Put output in file name
  1429.              /0TXDelay=ms - TXDelay (in MS) for Port 0 (Radio)
  1430.              /1TXDelay=ms - TXDelay (in MS) for Port 1 (Terminal)
  1431.              /0DWait=ms   - DWait (in MS) for Port 0
  1432.              /1DWait=ms   - DWait (in MS) for Port 1
  1433.              /0FULL       - Set Port 0 for Full Duplex operation
  1434.              /1FULL       - Set Port 1 for Full Duplex operation
  1435.              /L2FRack     - FRack (T1) for Level 2 Users
  1436.  
  1437.  
  1438.                                                                         24
  1439.  
  1440.  
  1441.              /L2RESptime  - RESptime (T2) for Level 2 Users
  1442.              /L2CHeck     - CHeck (T3) for Level 2 Users
  1443.              /L2RETry     - RETry (N2) for Level 2 Users
  1444.              /L2MAXframe  - MAXframe (W) for Level 2 Users
  1445.              /L3FRack     - FRack (T1) for X.25 Networking Trunks
  1446.              /L3RESptime  - RESptime (T2) for X.25 Networking Trunks
  1447.              /L3CHeck     - CHeck (T3) for X.25 Networking Trunks
  1448.              /L3RETry     - RETry (N2) for X.25 Networking Trunks
  1449.              /L3MAXframe  - MAXframe (W) for X.25 Networking Trunks
  1450.           
  1451.             IF TNC=TNC320 or TNC=PK88 then the following are valid:
  1452.           
  1453.                   /CPU=4915200    - CPU Clock frequency in HERTZ
  1454.                   /TICK=1200      - Frequency of clock on SYNCB or CTSB
  1455.                   /0BAUD=1200     - Radio Baud Rate
  1456.                   /1BAUD=9600     - Terminal Baud Rate
  1457.                   /LEDS=4         - Initial LED bit pattern
  1458.           
  1459.             IF TNC=TNC320
  1460.           
  1461.                   /MODEM=HF | VHF - Specify which modem should be used.
  1462.           
  1463.           NOTE: It is important to include the DNIC in the /ADDRESS.
  1464.                 The DNIC  for USA is 3100, so an address of 201779 would be
  1465.                 entered as /ADDRESS=3100201779.
  1466.  
  1467.                For example to create a Binary file for a TNC-320 for use on
  1468.           HF at  300 baud  with an  output file  of TNC320HF.BIN  enter the
  1469.           following command:
  1470.  
  1471.           C>MAKEPROM /TNC=TNC320 /MODEM=HF /0BAUD=300 /OUT=TNC320HF.BIN            MAKEPROM /TNC=TNC320 /MODEM=HF /0BAUD=300 /OUT=TNC320HF.BIN
  1472.  
  1473.                This will still bring up the display for inspection, you may
  1474.           also specify /NODISPLAY to skip the verification screen.                       /NODISPLAY                                 
  1475.  
  1476.                NOTE: If  you can not run MAKEPROM.EXE then you will have to
  1477.           perform the  following steps. Load the ROSEZSW.OVR into the EPROM
  1478.           burner in BINARY mode (Will fill locations 0000 to 7FFF) and then
  1479.           load the  .OVR file  for the  machine you  are using (TNC2.OVR or
  1480.           DR200.OVR or TNC320.OVR or PK88.OVR...). This will fill locations
  1481.           0000 to  0150. To make sure everything is OK, you should see FF's
  1482.           at some  locations below 0150H as well as below 7FFF. If you want
  1483.           to modify the default parameters see the following section.
  1484.  
  1485.      Permanent Configuration of the Switch     Permanent Configuration of the Switch
  1486.  
  1487.                Using the  MAKEPROM program you can modify many of the EPROM
  1488.           default parameters.  See the preceding section for information on
  1489.           using it. If you can not use it then you will have to combine the
  1490.           ".OVR" files  by hand and use the following information to modify
  1491.           the defaults.
  1492.  
  1493.                 The  distribution includes  a ".MAP" file that contains the
  1494.           EPROM address  of all entry points and important variables. Using
  1495.  
  1496.  
  1497.                                                                         25
  1498.  
  1499.  
  1500.           this information  you can  modify the  default parameters  in the
  1501.           EPROM. The  format of  the data  falls into four forms. A byte, a
  1502.           word, a callsign and a network address.
  1503.  
  1504.                A byte  is simply  a single  location in the EPROM which can
  1505.           hold a value from 00 to FF (that is 0 to 255 decimal).
  1506.  
  1507.                A word  is a  two byte  value with the low order byte of the
  1508.           word stored  at the  lower EPROM  address. A  word can  contain a
  1509.           value from 0000 to FFFF (that is 0 to 65535 decimal). Since it is
  1510.           stored low  byte at low address the value 01 00 is 1 decimal, and
  1511.           00 01 is 256 decimal, or 0100 hexadecimal.
  1512.  
  1513.                A callsign  is stored  in AX.25  format,  the  same  way  it
  1514.           appears in packets sent over the air. Each callsign is a six byte
  1515.           shifted ASCII  callsign followed  by  a  single  byte  SSID,  for
  1516.           example in the EPROM the callsign ROSE-3 would have the following
  1517.           format:
  1518.  
  1519.                A4 9E A6 8A 40 40 06
  1520.  
  1521.                Appendix 5  contains a  table for  conversion  from  and  to
  1522.           shifted ASCII as used in AX.25.
  1523.  
  1524.                A network  address is  stored in  CCITT X.25 address format,
  1525.           which is  a length  byte followed  by a BCD representation of the
  1526.           address, for  example  the  address  3100201779  would  have  the
  1527.           following format:
  1528.  
  1529.                0A 31 00 20 17 79
  1530.  
  1531.                Note that  the length  (0A, 10 decimal) is the number of BCD
  1532.           digits, ie "31" is two digits.
  1533.  
  1534.                If you  are outside  the USA  the  numbering  plan  may  use
  1535.           something other  than six  digit codes, if the length is ODD then
  1536.           just pad the last byte with an extra 0, but leave the length ODD.
  1537.           I know  Australia uses  a variable  length  numbering  plan,  the
  1538.           format for  node address  50502 (which  is the  region  code  for
  1539.           Sydney) would be:
  1540.  
  1541.                05 50 50 20
  1542.  
  1543.                Note that  the length  is 5  (50502) and  the last  digit is
  1544.           ignored and should be 0.
  1545.  
  1546.                The following  ".MAP" file  labels identify  the location of
  1547.           the following EPROM defaults:
  1548.  
  1549.                "myaddr"  - Network address of this switch
  1550.                "mycall"  - Callsign of this switch
  1551.                "mydigi"  - Callsign this switch recognized for digipeating
  1552.  
  1553.  
  1554.                                                                         26
  1555.  
  1556.  
  1557.      Power ON Indications for TNC-2     Power ON Indications for TNC-2
  1558.  
  1559.           Ensure that  the power  switch is off. Insert the power connector
  1560.           and then turn the power on.
  1561.  
  1562.           The ROSE  X.25 Packet  Switch  has  a  two  phase  initialization
  1563.           sequence.
  1564.  
  1565.           In the  first phase  you should  see the  PWR, CON and STA lights
  1566.           come on  for TWO  (2) seconds  while the  Switch  tests  RAM  and
  1567.           verifies the battery backed up RAM.
  1568.  
  1569.           The second  phase the  CON and STA LEDs are used to indicate what
  1570.           was going  on when the switch was powered off. This indication is
  1571.           displayed for  THREE (3) seconds (they both normally stay on). If
  1572.           they both  go out,  then the  switch was processing data when the
  1573.           power was  removed. When powering a unit as a ROSE Switch for the
  1574.           first time, this display is meaningless.
  1575.  
  1576.           At this  point the  CON and STA lights should alternately turn on
  1577.           and off  once  a  second,  this  indicates  that  the  switch  is
  1578.           operating correctly.
  1579.  
  1580.      Configuring a switch for the first time     Configuring a switch for the first time
  1581.  
  1582.                This section  will take you step by step through configuring
  1583.           a switch  for the  first time.  It is  assumed that the ROSE X.25
  1584.           Packet Switch has been installed and you are using a standard TNC
  1585.           on the air to connect to the switch.
  1586.  
  1587.                When a  switch is being installed for the first time it is a
  1588.           good idea  to run  the following  tests. First  you should verify
  1589.           that the  switch can  digipeat frames. Since the default callsign
  1590.           is ROSE-2, set UNPROTO as follows:
  1591.  
  1592.                cmd:unproto test via rose-2               cmd:                                          _______________________
  1593.                cmd:conv               cmd:                       ____
  1594.                Test               ____
  1595.                W2VY>TEST,ROSE-2*:Test               W2VY>TEST,ROSE-2*:Test
  1596.                
  1597.  
  1598.                The test  frame was digipeated successfully, indicating that
  1599.           the connections to the radio should be ok.
  1600.  
  1601.                Now we should verify that the switching callsign is correct,
  1602.           return to command mode (usually by typing Control-C) and enter:
  1603.  
  1604.                cmd:c rose-3               cmd:                           ________
  1605.                *** CONNECTED to ROSE-3               *** CONNECTED to ROSE-3
  1606.                [Hit return or wait 60 Seconds]
  1607.                ROSE X.25 Switch Version 890820 by Thomas A. Moulton, W2VY               ROSE X.25 Switch Version 890820 by Thomas A. Moulton, W2VY
  1608.                *** DISCONNECTED               *** DISCONNECTED
  1609.                cmd:               cmd:
  1610.                
  1611.  
  1612.  
  1613.                                                                         27
  1614.  
  1615.  
  1616.                This is  the default  information  message  and  so  all  is
  1617.           working correctly.
  1618.  
  1619.                The preceding  steps could  have been skipped, but these are
  1620.           strongly suggested  for any packet boards that have undergone any
  1621.           hardware modifications to install the switch.
  1622.  
  1623.                Now we can start the configuration process.
  1624.  
  1625.                At this  point it  is assumed  that  you  have  created  the
  1626.           configuration file  for this  switch (.CNF  file) and have run it
  1627.           through the  CONFIGUR program,  to  create  the  .TBL  file.  See
  1628.           Network Configuration and Running the Configuration Program.          Network Configuration     Running the Configuration Program 
  1629.  
  1630.                The  .TBL   file  needs   to  be   uploaded  to  the  CONFIG
  1631.           Application, See  Switching Applications,  first we  must  verify                            Switching Applications                         
  1632.           that the  CONFIG program is loaded in the switch. This is done by
  1633.           connecting to the application LOADER with the following command:
  1634.  
  1635.                cmd:c loader via rose-3,000000               cmd:                                             __________________________
  1636.                *** CONNECTED to LOADER VIA ROSE-3,000000               *** CONNECTED to LOADER VIA ROSE-3,000000
  1637.                ROSE X.25 Switch Version 890820 by Thomas A. Moulton, W2VY               ROSE X.25 Switch Version 890820 by Thomas A. Moulton, W2VY
  1638.                :0000000000               ___________
  1639.                Entry #0 LOADER - Application Boot interface               Entry #0 LOADER - Application Boot interface
  1640.                OK               OK
  1641.                
  1642.                This display  shows that  none of  the optional applications
  1643.           are loaded.   In  order  to  upload  the  .TBL  file  the  CONFIG
  1644.           application must be resident in memory.
  1645.  
  1646.                To load  the CONFIG  application into  memory  you  need  to
  1647.           upload the  file CONFIG.LOD  to the Loader. This file is an ASCII
  1648.           TEXT file, no special protocol should be used to send the file.
  1649.  
  1650.                You should  receive 3  OK's back  from the  loader. At  this                                      OK                                   
  1651.           point you can verify that the CONFIG application was successfully
  1652.           loaded by entering the following command:
  1653.  
  1654.                :0000000000               ___________
  1655.                Entry #0 LOADER - Application Boot interface               Entry #0 LOADER - Application Boot interface
  1656.                Entry #1 CONFIG - ROSE X.25 Packet Switch Configuration...               Entry #1 CONFIG - ROSE X.25 Packet Switch Configuration...
  1657.                OK               OK
  1658.                
  1659.                We are  now done  loading the  CONFIG  application  and  can
  1660.           disconnect from  the LOADER and connect to CONFIG to complete the
  1661.           configuration process.
  1662.  
  1663.                cmd:disc               cmd:    
  1664.                cmd:*** DISCONNECTED               cmd:*** DISCONNECTED
  1665.                cmd:c config v rose-3,000000               cmd:                                           ________________________
  1666.                *** CONNECTED to CONFIG VIA ROSE-3,000000               *** CONNECTED to CONFIG VIA ROSE-3,000000
  1667.                ROSE X.25 Switch Version 890820 by Thomas A. Moulton, W2VY               ROSE X.25 Switch Version 890820 by Thomas A. Moulton, W2VY
  1668.                
  1669.  
  1670.  
  1671.                                                                         28
  1672.  
  1673.  
  1674.                We are now connected to the CONFIG application, and can send
  1675.           the .TBL file to it. This file is also an ASCII TEXT file, upload
  1676.           with no special protocol.
  1677.  
  1678.                The CONFIG  application will  return  11  OK's  through  the                                                         OK                
  1679.           course of  processing the  file. Later  versions will  include  a
  1680.           message stating that the configuration is complete.
  1681.  
  1682.                When you have gotten all the OK's you can disconnect.
  1683.  
  1684.                cmd:disc               cmd:                       ____
  1685.                cmd:*** DISCONNECTED               cmd:*** DISCONNECTED
  1686.                
  1687.                The configuration  process is  now complete! At this point I
  1688.           usually like  to  verify  that  the  connect  text  was  uploaded
  1689.           correctly, since it is the last portion of the .TBL file.
  1690.  
  1691.                Since the switch is now configured you now use the switches'
  1692.           callsign, instead of ROSE-3, which is in this case W2VY-3
  1693.  
  1694.           cmd:c w2vy-3          cmd:                      ________
  1695.           *** CONNECTED to W2VY-3          *** CONNECTED to W2VY-3
  1696.           [Hit Return or wait 60 Seconds]
  1697.           ROSE X.25 Switch Version 890820 by Thomas A. Moulton, W2VY          ROSE X.25 Switch Version 890820 by Thomas A. Moulton, W2VY
  1698.           
  1699.           While Disconnected From THIS X.25 Switch issue a command like:          While Disconnected From THIS X.25 Switch issue a command like:
  1700.           
  1701.           C CALLSIGN-SSID V W2VY-3,201256          C CALLSIGN-SSID V W2VY-3,201256
  1702.           
  1703.                        Switches Available for User Access are:                       Switches Available for User Access are:
  1704.                Address   Callsign   Location             User Port Freq               Address   Callsign   Location             User Port Freq
  1705.                 201256   W2VY-3     Montclair              221.11 Mhz                201256   W2VY-3     Montclair              221.11 Mhz
  1706.                 201744   N2DSY-3    LittleFalls,NJ         145.07 Mhz                201744   N2DSY-3    LittleFalls,NJ         145.07 Mhz
  1707.                 609426   KA2VLP-3   Hightstown,NJ          145.07 Mhz                609426   KA2VLP-3   Hightstown,NJ          145.07 Mhz
  1708.                 609261   WA3YRI-3   MtHolly,NJ             145.07 Mhz                609261   WA3YRI-3   MtHolly,NJ             145.07 Mhz
  1709.                 212456   KD6TH-6    Manhattan,NY           145.07 Mhz                212456   KD6TH-6    Manhattan,NY           145.07 Mhz
  1710.                 609530   N2EVW-9    Ewing,NJ               221.01 Mhz                609530   N2EVW-9    Ewing,NJ               221.01 Mhz
  1711.                 609883   N2EVW-8    Trenton,NJ             221.11 Mhz                609883   N2EVW-8    Trenton,NJ             221.11 Mhz
  1712.                 201663   N2ELC-3    Lake Hopatcong,NJ       145.09 Mhz                201663   N2ELC-3    Lake Hopatcong,NJ       145.09 Mhz
  1713.                                              
  1714.              Possible connect paths available to access BBS User ports.             Possible connect paths available to access BBS User ports.
  1715.           C KB1BD-4 V W2VY-3,609426           C WA2VXT-4 v W2VY-3,609426          C KB1BD-4 V W2VY-3,609426           C WA2VXT-4 v W2VY-3,609426
  1716.           C KD6TH-4 V W2VY-3,201744           C N2ELC-4 v W2VY-3,201663          C KD6TH-4 V W2VY-3,201744           C N2ELC-4 v W2VY-3,201663
  1717.                                              
  1718.               Connect Paths Available to KA-Nodes or NETROM Facilities:              Connect Paths Available to KA-Nodes or NETROM Facilities:
  1719.           C WB2DRD-3 V W2VY-3,609426          C WB2MNF-3 V W2VY-3,609530          C WB2DRD-3 V W2VY-3,609426          C WB2MNF-3 V W2VY-3,609530
  1720.                                              
  1721.           When connecting  to NETROM  Nodes act  as if  you have  connected          When connecting  to NETROM  Nodes act  as if  you have  connected
  1722.           direct to  it.   Type C  NODENAME, after  you have  connected  to          direct to  it.   Type C  NODENAME, after  you have  connected  to
  1723.           either of  the netrom  nodes listed above, to connect to the next          either of  the netrom  nodes listed above, to connect to the next
  1724.           desired node. Type NODES to get a node list after your connect or          desired node. Type NODES to get a node list after your connect or
  1725.           type Info to get information about the particular netrom node you          type Info to get information about the particular netrom node you
  1726.           are connected to. Example:  To connect to ELK netrom node use the          are connected to. Example:  To connect to ELK netrom node use the
  1727.           following sequence:          following sequence:
  1728.  
  1729.  
  1730.                                                                         29
  1731.  
  1732.  
  1733.           C WB2DRD-3 V W2VY-3,6o9530          C WB2DRD-3 V W2VY-3,6o9530
  1734.           C ELK          C ELK
  1735.           
  1736.           You will  shortly be  Disconnected from  this switch.  If you are          You will  shortly be  Disconnected from  this switch.  If you are
  1737.           currently connected  via either  NETROM or  KA-Node RECONNECT  to          currently connected  via either  NETROM or  KA-Node RECONNECT  to
  1738.           THAT node  and then issue a connect as shown above.  Note: It has          THAT node  and then issue a connect as shown above.  Note: It has
  1739.           come to our attention that those systems using old TNC1 code will          come to our attention that those systems using old TNC1 code will
  1740.           not accept  all digit  fields, substitute  o for 0 and i for 1 in          not accept  all digit  fields, substitute  o for 0 and i for 1 in
  1741.           the all digit field and you will be successful.  Disconnect codes          the all digit field and you will be successful.  Disconnect codes
  1742.           can be  found on the KB1BD-4 PBBS, filename is DISCO.COD.  Please          can be  found on the KB1BD-4 PBBS, filename is DISCO.COD.  Please
  1743.           address questions  to  KB1BD@KB1BD  or  W2VY@KD6TH.  This  switch          address questions  to  KB1BD@KB1BD  or  W2VY@KD6TH.  This  switch
  1744.           brought to you courtesy of RATS.  Enjoy 73 Tom W2VY          brought to you courtesy of RATS.  Enjoy 73 Tom W2VY
  1745.           *** DISCONNECTED          *** DISCONNECTED
  1746.           cmd:          cmd:
  1747.  
  1748.                The configuration  process is  now complete.  It is strongly
  1749.           suggested that you do Not leave CONFIG loaded in the switch. This
  1750.           is because  it will  help avoid unauthorized access to update the
  1751.           configuration and  the memory can better be used for data buffers
  1752.           for connections.
  1753.  
  1754.      Configuring a switch for the second time     Configuring a switch for the second time
  1755.  
  1756.                The following  example shows  how to configure a switch that
  1757.           knows it's  callsign,  but  otherwise  it  is  identical  to  the
  1758.           preceding example. This will only need to be done if the switch's
  1759.           configuration needs  to be  changed, since  all the  routing  and
  1760.           network information is retained in battery backed up RAM.
  1761.  
  1762.                Since we normally do not keep CONFIG loaded we need to
  1763.           reload the CONFIG application.
  1764.  
  1765.                cmd:c loader v w2vy-3,201478               cmd:                                           ________________________
  1766.                *** CONNECTED to LOADER VIA W2VY-3,201478               *** CONNECTED to LOADER VIA W2VY-3,201478
  1767.                ROSE X.25 Switch Version 890820 by Thomas A. Moulton, W2VY               ROSE X.25 Switch Version 890820 by Thomas A. Moulton, W2VY
  1768.                :0000000000               ___________
  1769.                Entry #0 LOADER - Application Boot interface               Entry #0 LOADER - Application Boot interface
  1770.                OK               OK
  1771.                
  1772.                The CONFIG application is NOT loaded, so now you would send
  1773.           the file CONFIG.LOD, it is an ASCII TEXT file.
  1774.  
  1775.                You then get the 3 OK's and disconnect.
  1776.  
  1777.                cmd:d               cmd:                    _
  1778.                cmd:*** DISCONNECTED               cmd:*** DISCONNECTED
  1779.                
  1780.                cmd:c config v w2vy-3,201478               cmd:c config v w2vy-3,201478
  1781.                *** CONNECTED to CONFIG VIA W2VY-3,201478               *** CONNECTED to CONFIG VIA W2VY-3,201478
  1782.                ROSE X.25 Switch Version 890820 by Thomas A. Moulton, W2VY               ROSE X.25 Switch Version 890820 by Thomas A. Moulton, W2VY
  1783.                
  1784.                Now send the .TBL file and receive 11 OK's, when done
  1785.           disconnect.
  1786.  
  1787.  
  1788.                                                                         30
  1789.  
  1790.  
  1791.                cmd:d               cmd:d
  1792.                cmd:*** DISCONNECTED               cmd:*** DISCONNECTED
  1793.                cmd:               cmd:
  1794.                
  1795.                The switch is now reconfigured.
  1796.  
  1797.      Configuring a Remote Switch     Configuring a Remote Switch
  1798.  
  1799.                In an operational network any switch can be loaded from any
  1800.           point within the network. You just need to issue a connect
  1801.           command to your TNC that had the callsign of the local switch,
  1802.           followed by the network address of the switch you wish to
  1803.           interact with.
  1804.  
  1805.                When accessing a completely unconfigured switch remember the
  1806.           default callsign is ROSE-3 and the default address is 000000.
  1807.           This should only happen the first time you bring up a switch, see
  1808.           the section Configuring a Switch for the first time for a step by                      Configuring a Switch for the first time              
  1809.           step example. If you notice that the switch fails to remember
  1810.           it's callsign after the power has been removed for a short time,
  1811.           that may indicate that the battery needs replacing. Lithium
  1812.           batteries are usually good for 3 Years - TAPR TNC-2's should be
  1813.           needing new batteries soon!
  1814.  
  1815.                You can also use MAKEPROM to program different callsign and
  1816.           address defaults.
  1817.  
  1818.      Loading a Switch after a Power Failure     Loading a Switch after a Power Failure
  1819.  
  1820.                When a switch or site undergoes a power failure the connect
  1821.           text and any loadable applications are lost. The switch can still
  1822.           perform network routing and switching. You will need to connect
  1823.           to LOADER and send the applications that you normally use
  1824.           (INFO.LOD, HEARD.LOD, etc). The process is the same as loading
  1825.           CONFIG, as shown in the proceeding examples. You may also send
  1826.           the ".TBL" file to reload the connect text. See the description
  1827.           of the LOADER for additional information.
  1828.  
  1829.      Hardware Installation - TNC-2 or Clone     Hardware Installation                 
  1830.  
  1831.      Tools  Required:   Small  Philips   screwdriver  and   small  standard
  1832.           screwdriver.
  1833.  
  1834.           Remove power and all external connections to the TNC.
  1835.  
  1836.           Remove the  two philips  screws on the front panel and remove the
  1837.           screw in the heat sink. There is no screw on TNC-2 Rev 1 boards.
  1838.  
  1839.           If the  unit is  an MFJ  remove two  standard screws  on sides of
  1840.           cabinet and remove the lid.
  1841.  
  1842.           Locate the program EPROM, this is normally U23, towards the front
  1843.           of the  packet controller,  next to the Z80 (big 40 pin chip that
  1844.           is 2" long). The EPROM is along side the Z80 and RAMs.
  1845.  
  1846.  
  1847.                                                                         31
  1848.  
  1849.  
  1850.           The EPROM should be a labeled with something like 1.1.6 (1.1.1 up
  1851.           to 1.1.6).  It should NOT say "STATE 1.09", that EPROM is part of
  1852.           the modem. The program EPROM is U23.
  1853.  
  1854.           When you have located the EPROM note the direction the end with a
  1855.           small notch is pointing. This designates which end pin #1 located
  1856.           on. If  you install  an EPROM backwards you can damage it, either
  1857.           destroying the program or making the EPROM completely unusable.
  1858.  
  1859.           Use the  small standard  screwdriver to  lift the  EPROM a little
  1860.           above the socket.
  1861.  
  1862.           WARNING: Make  SURE you are not lifting the socket off the board.          WARNING: Make  SURE you are not lifting the socket off the board.
  1863.           Just put the corner of the screwdriver under the EPROM for now.          Just put the corner of the screwdriver under the EPROM for now.
  1864.  
  1865.           Once the  EPROM is above the surface of the socket you can insert
  1866.           the screwdriver a bit further. Try to lift the EPROM straight up,
  1867.           insert the  screwdriver as  far as it will easily go and lift the
  1868.           EPROM a  little more.  Repeat until the screwdriver is completely
  1869.           under the EPROM.
  1870.  
  1871.           If you bend any of the pins it might be a good idea to leave them
  1872.           alone until it is reused.  (The person erasing/re-programming the
  1873.           EPROM will very likely have experience with bent pins!)
  1874.  
  1875.           Make sure  the socket  is flat  and not lifted on either end from
  1876.           the board.
  1877.  
  1878.           When pressing  the EPROM into the socket it is best to press from
  1879.           the bottom  of the board as well as the on EPROM. If the EPROM is
  1880.           new the  pins will  be spread much wider than the pin rows in the
  1881.           socket. To  better align the pins you can place the EPROM on each
  1882.           edge (pins  on a table) and apply firm pressure while raising the
  1883.           chip portion  to the  vertical position. Do this for both rows of
  1884.           pins.
  1885.  
  1886.           Don't go to far! It is easier to do it again then it is to unbend
  1887.           the pins.
  1888.  
  1889.           Take the  ROSEZSW (ROSE  Z80 SWitch)  EPROM and  install  in  the
  1890.           vacated socket. Ensure the notch is pointed in the same direction
  1891.           as the  old EPROM,  as well as the silhouette on the board. Align
  1892.           both rows of pins and let the EPROM slide in a little, then check
  1893.           for stuck  pins. Slight  pressure on  the side  of each  pin will
  1894.           insure it is started into the socket straight.
  1895.  
  1896.           Go little by little watching for bending pins.
  1897.  
  1898.           After the  EPROM is  installed, check  for bent  pins by  looking
  1899.           under and along the sides for an unusual seating.
  1900.  
  1901.           Make sure  the notch in the new EPROM has the same orientation as
  1902.           the original EPROM.
  1903.  
  1904.  
  1905.                                                                         32
  1906.  
  1907.  
  1908.           Re-assemble the unit.
  1909.  
  1910.      Hardware Installation - PacComm DR-100/DR-200     Hardware Installation                        
  1911.  
  1912.           Read the  installation instructions for the TNC-2, above for some
  1913.           precautions on EPROM handling, removal and insertion.
  1914.  
  1915.           The program EPROM is located at position U2, in the center of the
  1916.           board, near the Z80.
  1917.  
  1918.           See also Hardware Modifications - DR-100/DR-200 for some required                   Hardware Modifications - DR-100/DR-200                  
  1919.           changes to the board.
  1920.  
  1921.           The port  that is  next to  the RESET  pin is  SCC Port B, and is
  1922.           called Port 0 by the ROSE Switch.
  1923.  
  1924.           DR-100 Note:  You will  need to  change the USERPORT statement in
  1925.           the configuration   file to  be "USERPORT  1" as  the DR-100 only
  1926.           has one  port and  it is set up at the same address as the DR-200
  1927.           Port 1.
  1928.  
  1929.           The daughter  board is  not currently  supported. (It has a TNC-2
  1930.           style modem disconnect so it's the simplest way to attach the NB-
  1931.           9600 High Speed modem)
  1932.  
  1933.      Hardware Modifications - TNC-2 or Clone     Hardware Modifications                 
  1934.  
  1935.           There are  no modifications  that are required to set up a single
  1936.           port switch, there are a couple of things that would be desirable
  1937.           for a busy switch.
  1938.  
  1939.           These are:
  1940.  
  1941.           1) 32K RAM upgrade
  1942.  
  1943.           2) Change the CPU clock to 4.9 MHz (JMP2 on TNC-2)
  1944.  
  1945.           The following modifications are required if you intend to use the
  1946.           asynchronous port  on a  radio or  tied back to back with another
  1947.           TNC:
  1948.  
  1949.           Note: ALL MODIFICATIONS ARE TO THE BOTTOM (FOIL SIDE)!          Note: ALL MODIFICATIONS ARE TO THE BOTTOM (FOIL SIDE)!
  1950.  
  1951.           1) Add  a jumper  from J1  pin 23 to JMP 9 pin 3, note that JMP 9
  1952.           has pins 1, 2 and 3 tied together.
  1953.  
  1954.           2) If you want to run the asynchronous port at 4800 baud or above
  1955.           U3 (LM324) should be changed to a TL084.
  1956.  
  1957.           3) If running back to back with other TNCs add jumper from J1 Pin
  1958.           10 to  J1 Pin 20, this should be done in the cable. If connecting
  1959.           to a  Radio do  not add this jumper, see Wiring TNCs for Back-to-                                                   Wiring TNCs for Back-to-
  1960.           Back Mode for a complete description.          Back Mode                            
  1961.  
  1962.  
  1963.                                                                         33
  1964.  
  1965.  
  1966.      Hardware Modifications - DR-100/DR-200     Hardware Modifications                
  1967.  
  1968.           There are  two types  of modifications  listed  for  the  DR-200,
  1969.           required and  optional. The  required changes  are to  supply the
  1970.           Transmit and  Receive Clocks  to the  Zilog Serial  Communication
  1971.           Controller (Z8530)  chip, which sets the baud rate for each port,
  1972.           and removal  of the "Processor WatchDog Timer" which was found to
  1973.           be ineffective.  The optional  changes are  modifications to  the
  1974.           modem circuit  that have,  in some  cases  increased  performance
  1975.           dramatically.
  1976.  
  1977.           Note: Ux/n  means chip  marked Ux pin n, on IC's the end with the
  1978.           notch has pin #1. When viewed from the top, pin #1 is just to the
  1979.           left of the notch.
  1980.  
  1981.           Note: All  wires should be added to the solder side of the board,
  1982.           do not attach wires to the chip pins!!
  1983.  
  1984.           Required:          Required:
  1985.  
  1986.           U14 = 7910 Port A; U15 = 8530 SCC; U16 = 7910 Port B
  1987.  
  1988.           Jumper U14/25 to U15/19
  1989.           Jumper U16/25 to U15/21
  1990.  
  1991.           This connects the DCD outputs of the 7910's to the SCC.
  1992.  
  1993.           The baud rate generator is U12, which is located next to the 7910
  1994.           (U14) on the same side as the Z80.  A jumper is required for both the
  1995.           TX and RX clock of each port, FOUR (4) jumpers should be installed.
  1996.           This allows different baud rates for each port. To select the correct
  1997.           clocks use the following table:
  1998.  
  1999.                U12 Pin   RXClock        TXClock
  2000.                 7        9600
  2001.                 5        4800
  2002.                 4        2400
  2003.                 6        1200
  2004.                13         600
  2005.                12         300           9600
  2006.                14                       4800
  2007.                15                       2400
  2008.                 1                       1200
  2009.                 2                       600
  2010.                 3                       300
  2011.      
  2012.                The SCC Pins are defined as follows:
  2013.  
  2014.                Port #    RXClock        TXClock
  2015.                  0       U15 28         U15 26
  2016.                  1       U15 12         U15 14
  2017.                
  2018.                For dual port operation with both ports running at 1200
  2019.                baud install the following jumpers:
  2020.  
  2021.  
  2022.                                                                         34
  2023.  
  2024.  
  2025.                U15/28 and U15/12 to U12/6  (RXClock)
  2026.                U15/26 and U15/14 to U12/1  (TXClock)
  2027.                
  2028.                For Port 0 at 1200 Baud and Port 1 at 300 Baud
  2029.                
  2030.                U15/28 to U12/6  (RXClock Port 0)
  2031.                U15/26 to U12/1  (TXClock Port 0)
  2032.                U15/12 to U12/12 (RXClock Port 1)
  2033.                U15/14 to U12/3  (TXClock Port 1)
  2034.  
  2035.           Note: ALL MODIFICATIONS ARE TO THE BOTTOM (FOIL SIDE)!          Note: ALL MODIFICATIONS ARE TO THE BOTTOM (FOIL SIDE)!
  2036.  
  2037.           A Processor  Watchdog Timer  is a  circuit that  is  designed  to
  2038.           ensure the  CPU does  not get  hung (dead)  due to a power glitch
  2039.           (normally a programmer's bug).  The Processor Watchdog circuit is
  2040.           not compatible  with the normal operation of a ROSE Switch and if
  2041.           it is  not removed  the ROSE  Switch will  operate in  an erratic
  2042.           fashion.
  2043.  
  2044.           Remove U19  located next to one of the audio lines, opposite edge
  2045.           of board  from EPROM.   Also  remove C32 and install U7 (74HC132)
  2046.           with pins  3, 12  and 13 uninserted and add a jumper from U7/3 to
  2047.           U7/12, this  cleans up  the reset  line since the watchdog is now
  2048.           out of the circuit.
  2049.  
  2050.           Optional:          Optional:
  2051.  
  2052.           Remove the  RX Audio filtering (U17 and U20), the modem will work
  2053.           better on  it's own.  I removed  U17, R21, R23, Diodes at C24 and
  2054.           installed a  0.1 uf at C24 and Jumper JP-FA. And the same for the
  2055.           other port (Remove U20, R34, R33, Diodes at C45 and installed 0.1
  2056.           uf at  C45 and Jumper JP-FB). If you use the modem on HF remember
  2057.           the tones are 425 hz higher (.5 khz on dial should be ok) and you
  2058.           need to reduce the RF Gain so the background static is below 10mv
  2059.           (audio). Might  want to  use the  R33/R30 voltage divider and add
  2060.           jumper from  their junction to the other side of JP-FB and remove
  2061.           C41 and leave JP-FB uninstalled.
  2062.  
  2063.           Note: ALL MODIFICATIONS ARE TO THE BOTTOM (FOIL SIDE)!          Note: ALL MODIFICATIONS ARE TO THE BOTTOM (FOIL SIDE)!
  2064.  
  2065.      Asynchronous Communications     Asynchronous Communications
  2066.  
  2067.                The ROSE  X.25 Packet  Switch supports the asynchronous port
  2068.           of a  TNC-2 or  Clone as  just another radio port. The goal is to
  2069.           allow connection  to any standard RS-232 device, such as a modem.
  2070.           The RS-232  signals operate  in a  normal  fashion  which  allows
  2071.           connection to  conventional land  line modem, multiplexers or any
  2072.           other communications  equipment  that  is  available  to  provide
  2073.           backbone linking.
  2074.  
  2075.                The immediate  application is connection of a Bell 202 modem
  2076.           and a  radio to  provide a  local backbone for a given area. This
  2077.           type of set up requires half as many TNC's!
  2078.  
  2079.  
  2080.                                                                         35
  2081.  
  2082.  
  2083.                Two or more switches may also be tied together on the RS-232
  2084.           ports to provide multiple synchronous ports from a single site.
  2085.  
  2086.           TNC-2 Asynchronous Port Definition
  2087.  
  2088.           All connections are to J1 (DB 25)
  2089.  
  2090.           Pin #     Direction/EIA Pin Designation/Usage
  2091.            1        NA/Frame Ground
  2092.            2        In/TXD/Data On
  2093.            3        Out/RXD/Data Out
  2094.            5        Out/CTS/Request To Send (Async PTT)
  2095.            7        NA/Ground
  2096.            9        Out/HI/Pull Up Signal (+12 VDC)
  2097.           10        Out/LO/Pull Down signal (-12 VDC)
  2098.           20        In/DTR/If LO wired to a diode matrix cable
  2099.                     . /If not LO wired to a standard RS-232 device
  2100.           23        In/SEL/Carrier Detect
  2101.  
  2102.           PacComm Asynchronous Port Definition
  2103.  
  2104.           All connections are to RS-232 Connector (DE 9)
  2105.  
  2106.           Pin #     Direction/EIA Pin Designation/Usage
  2107.            2        Out/RXD/Data Out
  2108.            3        In/TXD/Data On
  2109.            5        NA/Frame Ground
  2110.            6        Out/DSR/Pull Up Signal (+12 VDC)
  2111.            7        In/DTR/If LO wired to a diode matrix cable
  2112.                     . /If not LO wired to a standard RS-232 device
  2113.            8        Out/CTS/Request To Send (Async PTT)
  2114.            9        In/SEL/Carrier Detect
  2115.  
  2116.           AEA Asynchronous Port Definition
  2117.  
  2118.           All connections are to J1 (DB 25)
  2119.  
  2120.           Pin #     Direction/EIA Pin Designation/Usage
  2121.            1        NA/Frame Ground
  2122.            2        In/TXD/Data On
  2123.            3        Out/RXD/Data Out
  2124.            4        In/DTR/If LO wired to a diode matrix cable
  2125.                     . /If not LO wired to a standard RS-232 device
  2126.            5        Out/CTS/Request To Send (Async PTT)
  2127.            6        Out/DSR/Pull Up Signal (+12 VDC)
  2128.            7        NA/Ground
  2129.            8*       Out/LO/Pull Down signal (-12 VDC)
  2130.           23*       In/SEL/Carrier Detect
  2131.  
  2132.           Note: JP-3 Must be in position B (Toward Front of board) and JP-9
  2133.                 must be soldered ON
  2134.  
  2135.  
  2136.                                                                         36
  2137.  
  2138.  
  2139.      Asynchronous Radio Port Cables     Asynchronous Radio Port Cables
  2140.  
  2141.           TNC-2 to Radio Port Cable
  2142.  
  2143.           CAPS mean TNC, lower means Modem DB25
  2144.  
  2145.           GND PIN  1 - gnd pin  1
  2146.           TXD PIN  2 - rxd pin  3
  2147.           RXD PIN  3 - txd pin  2
  2148.           CTS PIN  5 - rts pin  4 (Radio keying circuit/PTT)
  2149.           DSR PIN  6 - dtr pin 20 (depending on Modem)
  2150.           GND PIN  7 - gnd pin  7 (Optional)
  2151.           DTR PIN 20 - HI PIN   9 (Use RS-232 Signaling)
  2152.           SEL PIN 23 - dcd pin  8 (Tie Modem DCD to sio dcdb)
  2153.  
  2154.           PacComm Packet Controller to Radio Port Cable
  2155.  
  2156.           CAPS mean TNC, lower means Modem DB25
  2157.  
  2158.           RXD PIN 2 - txd pin  2
  2159.           TXD PIN 3 - rxd pin  3
  2160.           GND PIN 5 - gnd pin  1
  2161.           DSR PIN 6 - dtr pin 20 (depending on Modem)
  2162.           DTR PIN 7 - DSR PIN  6 (RS-232 Interface)
  2163.           CTS PIN 8 - rts pin  4 (Radio keying circuit/PTT)
  2164.           SEL PIN 9 - dcd pin  8 (Tie Modem DCD to sio dcdb)
  2165.  
  2166.           AEA TNC to Radio Port Cable
  2167.  
  2168.           CAPS mean TNC, lower means Modem DB25
  2169.  
  2170.           GND PIN  1 - gnd pin  1
  2171.           TXD PIN  2 - rxd pin  3
  2172.           RXD PIN  3 - txd pin  2
  2173.           DTR PIN  4 - DSR PIN  6 (Use RS-232 Signaling)
  2174.           CTS PIN  5 - rts pin  4 (Radio keying circuit/PTT)
  2175.           DSR PIN  6 - dtr pin 20 (depending on Modem)
  2176.           GND PIN  7 - gnd pin  7 (Optional)
  2177.           SEL PIN 23*- dcd pin  8 (Tie Modem DCD to sio dcdb)
  2178.  
  2179.           Note: JP-3 Must be in position B (Toward Front of board) and JP-9
  2180.                 must be soldered ON
  2181.  
  2182.  
  2183.                                                                         37
  2184.  
  2185.  
  2186.      Wiring two TNCs for Back-to-Back Operation     Wiring two TNCs for Back-to-Back Operation
  2187.  
  2188.           Each of the following will describe a single end of the cable.
  2189.  
  2190.           TNC-2 End of a Dual Back to Back Cable
  2191.  
  2192.           CAPS mean this TNC, lower means the other TNC
  2193.  
  2194.           GND PIN  1 ------ gnd
  2195.           TXD PIN  2 ------ rxd
  2196.           RXD PIN  3 ------ txd
  2197.           CTS PIN  5 ------ sel
  2198.           GND PIN  7 ------ gnd
  2199.           DTR PIN 20 ------ (open)
  2200.           SEL PIN 23 ------ cts
  2201.  
  2202.           PacComm Packet Controller End of a Dual Back to Back Cable
  2203.  
  2204.           CAPS mean this TNC, lower means the other TNC
  2205.  
  2206.           RXD PIN 2 ------ txd
  2207.           TXD PIN 3 ------ rxd
  2208.           GND PIN 5 ------ gnd
  2209.           DTR PIN 7 ------ (open)
  2210.           CTS PIN 8 ------ sel
  2211.           SEL PIN 9 ------ cts
  2212.  
  2213.           AEA PK-88 End of a Dual Back to Back Cable
  2214.  
  2215.           CAPS mean this TNC, lower means the other TNC
  2216.  
  2217.           GND PIN  1 ------ gnd
  2218.           TXD PIN  2 ------ rxd
  2219.           RXD PIN  3 ------ txd
  2220.           DTR PIN  4 ------ (open)
  2221.           CTS PIN  5 ------ sel
  2222.           GND PIN  7 ------ gnd
  2223.           SEL PIN 23*------ cts
  2224.  
  2225.           Note: JP-3 Must be in position B (Toward Front of board) and JP-9
  2226.                 must be soldered ON
  2227.  
  2228.      Differences between ROSE and Net/ROM Back-to-Back Cable     Differences between ROSE and Net/ROM Back-to-Back Cable
  2229.  
  2230.                The ROSE Switch now also supports usage of the Net/ROM style
  2231.           of diode  matrix cable/board.  Follow the normal construction but
  2232.           swap the wires going to Pin 20 and Pin 23.
  2233.  
  2234.      Wiring many TNCs for Back-to-Back Operation     Wiring many TNCs for Back-to-Back Operation
  2235.  
  2236.                There are  two methods for connecting more than two switches
  2237.           back to  back. The diode matrix cable previously used for Net/ROM
  2238.           can be used with a simple change, see above.
  2239.  
  2240.  
  2241.                                                                         38
  2242.  
  2243.  
  2244.                To use standard RS-232 signals you will need the PacComm RS-
  2245.           232 LAN  card. The advantage of this board is that RS-232 will be
  2246.           more reliable  over long  cable runs  and  it  can  interface  to
  2247.           standard devices  such as  Landline Modems  or multiplexers. This
  2248.           can be useful for attaching to "WormHoles" we can find at or near
  2249.           our offices!
  2250.  
  2251.      Conclusion     Conclusion
  2252.  
  2253.                The ROSE  X.25 Packet  Switch is  the most  advanced  packet
  2254.           switch for  amateur packet  networking. The growing collection of
  2255.           features and  use of state of the art protocols enable it to play
  2256.           a key role in the growing Global Amateur Packet Network.
  2257.  
  2258.                This is  just the  first  tool  for  the  RATS  Open  System
  2259.           Environment. Other  projects have  been identified  and  will  be
  2260.           supported by  or supportive  of the  ROSE X.25 Packet Switch. The
  2261.           Radio  Amateur   Telecommunications  Society   is  committed   to
  2262.           development of  state of  the  art  networking  for  the  amateur
  2263.           service.
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.      Appendix 1 - Files Supplied in archive     Appendix 1 - Files Supplied in archive
  2271.           
  2272.           The following files are included in the archive RZSWmmdd.ZIP:
  2273.           (Where mm is the month and dd is the day of the release)
  2274.           
  2275.           PKZIP (tm)   Version 1.01   07-21-89
  2276.           
  2277.           Searching ZIP: RZSW1130.ZIP
  2278.           
  2279.            Length  Method    Date    Time   CRC-32  Attr  Name
  2280.            ------  ------    ----    ----   ------  ----  ----
  2281.              4644  Implode 12-07-89  19:00  5ee71ccd --w  CONFIG.LOD
  2282.             26700  Implode 10-28-89  17:44  6df18d49 --w  CONFIGUR.EXE
  2283.               994  Implode 12-02-89  14:12  7ce9c027 --w  MEMSIZ.LOD
  2284.              4495  Implode 06-05-89  12:16  c935b21f --w  NPA.ARC
  2285.              1450  Implode 04-11-89  00:29  346f00b7 --w  RATSINFO.TXT
  2286.              1015  Implode 04-11-89  00:28  24745c65 --w  RATSMBR.TXT
  2287.              9995  Implode 12-03-89  14:50  b20201eb --w  READZSW.ME
  2288.              3869  Implode 07-24-89  10:40  c28f67ce --w  REGISTER.TXT
  2289.             13298  Implode 12-01-89  10:14  10b63da8 --w  ROSEZSW.LST
  2290.             11612  Implode 12-01-89  10:16  eda5bfdd --w  ROSEZSW.MAP
  2291.              6397  Implode 12-07-89  19:19  8070a669 --w  USERS.LOD
  2292.              1578  Implode 09-12-89  22:13  5c6ff455 --w  W2VY-3.CNF
  2293.              1364  Implode 10-01-89  11:09  d56805df --w  LOCALNET.TXT
  2294.               230  Shrunk  12-02-89  13:11  f97b7011 --w  BOOTER.LOD
  2295.             32749  Implode 12-01-89  10:16  c12e4e64 --w  ROSEZSW.OVR
  2296.               258  Shrunk  12-02-89  21:44  010ab958 --w  TNC2.OVR
  2297.              3768  Implode 12-02-89  13:12  e0b5e234 --w  INFO.LOD
  2298.               257  Shrunk  12-02-89  21:45  9324d93c --w  DR200.OVR
  2299.               301  Shrunk  12-02-89  21:46  fe70954d --w  TNC320.OVR
  2300.               287  Shrunk  12-02-89  21:46  9352a622 --w  PK88.OVR
  2301.             23262  Implode 12-03-89  09:24  165e2ecc --w  MAKEPROM.EXE
  2302.              7166  Implode 12-07-89  18:21  8302ace5 --w  HEARD.LOD
  2303.            ------                                         -------
  2304.            155689                                          22
  2305.           
  2306.           
  2307.           READZSW.ME   - Boot strap information as well as changes from the
  2308.                          previous release.
  2309.  
  2310.           ROSESYS.DOC  - SYSOP Information on installation and
  2311.                          configuration (THIS FILE).
  2312.  
  2313.           ROSEUSER.DOC - User manual for the Switch.
  2314.  
  2315.           CONFIGUR.EXE - IBM PC executable that converts the network
  2316.                          description file (xyz.CNF) to a file that is
  2317.                          loadable into a switch CONFIG application
  2318.                          (xyz.TBL).
  2319.  
  2320.           CONFIG.LOD   - The configuration interface that is executed on
  2321.                          the switch while uploading the ".TBL" file.
  2322.  
  2323.  
  2324.  
  2325.  
  2326.  
  2327.           MEMSIZ.LOD   - Simple test application, gives you the amount of
  2328.                          memory used.
  2329.  
  2330.           USERS.LOD    - Application that provides the user with a list of
  2331.                          all active connections to or through a switch.
  2332.  
  2333.           INFO.LOD     - Application to access TEXT of remote switch and
  2334.                          also provides text messages for Reset and
  2335.                          Disconnect messages.
  2336.  
  2337.           HEARD.LOD    - Application that keeps track of what stations the
  2338.                          switch has heard. Keeps track of how long ago they
  2339.                          were heard, the first time heard, number of frames
  2340.                          heard and frame type of the last frame heard.
  2341.  
  2342.           NPA.ARC      - Archive that contains all the Area Codes in the
  2343.                          USA and Canada broken down by state/province and
  2344.                          by call area.
  2345.  
  2346.           ROSEZSW.BIN  - Binary image suitable for EPROM programming.
  2347.  
  2348.           ROSEZSW.HEX  - Intel HEX format file suitable for EPROM
  2349.                          programming.
  2350.  
  2351.           ROSEZSW.LST  - Assembly listing to aid the custom modification of
  2352.                          some of the default parameters.
  2353.  
  2354.           ROSEZSW.MAP  - Address map of all entry points and global
  2355.                          variables, useful in custom modification of
  2356.                          default parameters.
  2357.  
  2358.           TNC2.OVR, TNC320.OVR, PK88.OVR, DR200.OVR
  2359.           and
  2360.           ROSEZSW.OVR  - Overlay files used by MAKEPROM.EXE to create the
  2361.                          EPROM for a specific machine.
  2362.  
  2363.           MAKEPROM.EXE - MS-DOS Program used to create EPROM Image to be
  2364.                          burned into an EPROM.
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.      Appendix 2 - ROSE X.25 Packet Switch User's Manual     Appendix 2 - ROSE X.25 Packet Switch User's Manual
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.      Appendix 3 - Network Configuration Example     Appendix 3 - Network Configuration Example
  2377.      
  2378.           DEFAULT PORT 0
  2379.           DEFAULT TIMEOUT 900
  2380.           DEFAULT L3W 4
  2381.           DEFAULT MAXVC 20
  2382.           
  2383.           THIS DNIC 3100 United States of America
  2384.           
  2385.           THIS NODE Clifton
  2386.           ADDRESS 201478
  2387.           CALL W2VY-3
  2388.           DIGI W2VY-2
  2389.           COVERAGE
  2390.           201472 201473 201777 201779 201470 201478
  2391.           201778 201772
  2392.           END
  2393.           USERPORT 0
  2394.           TEXT
  2395.           $
  2396.           While Disconnected From THIS X.25 Switch issue a command like:
  2397.           $
  2398.           C CALLSIGN-SSID V W2VY-3,201256
  2399.           $
  2400.                        Switches Available for User Access are:
  2401.                Address   Callsign   Location             User Port Freq
  2402.                 201256   W2VY-3     Montclair              221.11 Mhz
  2403.                 201744   N2DSY-3    LittleFalls,NJ         145.07 Mhz
  2404.                 609426   KA2VLP-3   Hightstown,NJ          145.07 Mhz
  2405.                 609261   WA3YRI-3   MtHolly,NJ             145.07 Mhz
  2406.                 212456   KD6TH-6    Manhattan,NY           145.07 Mhz
  2407.                 609530   N2EVW-9    Ewing,NJ               221.01 Mhz
  2408.                 609883   N2EVW-8    Trenton,NJ             221.11 Mhz
  2409.                 201663   N2ELC-3    Lake Hopatcong,NJ       145.09 Mhz
  2410.           $
  2411.              Possible connect paths available to access BBS User ports.
  2412.           C KB1BD-4 V W2VY-3,609426           C WA2VXT-4 v W2VY-3,609426
  2413.           C KD6TH-4 V W2VY-3,201744           C N2ELC-4 v W2VY-3,201663
  2414.           $
  2415.               Connect Paths Available to KA-Nodes or NETROM Facilities:
  2416.           C WB2DRD-3 V W2VY-3,609426          C WB2MNF-3 V W2VY-3,609530
  2417.           $
  2418.           When connecting  to TheNet  Nodes act  as if  you have  connected
  2419.           direct to  it.   Type C  NODENAME, after  you have  connected  to
  2420.           either of  the TheNet  nodes listed above, to connect to the next
  2421.           desired node. Type NODES to get a node list after your connect or
  2422.           type Info to get information about the particular TheNet node you
  2423.           are connected to. Example:  To connect to ELK TheNet node use the
  2424.           following sequence:
  2425.           C WB2DRD-3 V W2VY-3,6o9530
  2426.           C ELK
  2427.           $
  2428.           You will  shortly be  Disconnected from  this switch.  If you are
  2429.           currently connected  via either  TheNET or  KA-Node RECONNECT  to
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.           THAT node  and then issue a connect as shown above.  Note: It has
  2436.           come to our attention that those systems using old TNC1 code will
  2437.           not accept  all digit  fields, substitute  o for 0 and i for 1 in
  2438.           the all digit field and you will be successful.  Disconnect codes
  2439.           can be  found on the KB1BD-4 PBBS, filename is DISCO.COD.  Please
  2440.           address questions  to  KB1BD@KB1BD  or  W2VY@KD6TH.  This  switch
  2441.           brought to you courtesy of RATS.  Enjoy 73 Tom W2VY
  2442.           $EOF
  2443.           END
  2444.           
  2445.           NODE Manhattan
  2446.           ADDRESS 212456
  2447.           PATH KD6TH-3
  2448.           END
  2449.           
  2450.           NODE LittleFalls
  2451.           ADDRESS 201744
  2452.           PATH N2DSY-3
  2453.           END
  2454.           
  2455.           NODE Clifton2
  2456.           ADDRESS 201779
  2457.           PATH W2VY-9
  2458.           PORT 1
  2459.           END
  2460.           
  2461.           NODE Montclair
  2462.           ADDRESS 201256
  2463.           PATH W2VY-12 Via KB1BD-2
  2464.           END
  2465.           
  2466.           USER KD6THbbs
  2467.           PATH KD6TH-4
  2468.           PORT 1
  2469.           MAXVC 0
  2470.           END
  2471.           
  2472.           Route to Nodes Manhattan LittleFalls
  2473.           Calls for
  2474.           207 802 617 508 413 203 401
  2475.           518 607 212 718 716 516 914 315
  2476.           end
  2477.           
  2478.           Route to Node Manhattan
  2479.           Calls for
  2480.           212456
  2481.           end
  2482.           
  2483.           Route to Node LittleFalls
  2484.           Calls for
  2485.           201744
  2486.           end
  2487.           
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.           Route to Node LittleFalls
  2494.           Calls for
  2495.           609 215 717 202
  2496.           end
  2497.           
  2498.           DNIC 0
  2499.           Route to Node LittleFalls
  2500.           Calls for
  2501.           3020
  2502.           end
  2503.           
  2504.           WRITE w2vy-3.tbl
  2505.           QUIT
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.      Appendix 4 - Terminology     Appendix 4 - Terminology
  2512.  
  2513.                A Link  is a  connection between  two stations,  either  two                 ____                                                      
  2514.           users, two switches or a user and a switch.
  2515.  
  2516.                A Virtual  Circuit, or  VC is a connection for data transfer                 ________________________                                  
  2517.           between two  users, in a multi-switch networking environment this
  2518.           may involve more than one Link.                                    ____ 
  2519.  
  2520.                A Network  Address is  a number  that  identifies  an  entry                 ________________                                          
  2521.           and/or exit point of the network.
  2522.  
  2523.                A Call  or Call  Request is  what a  user or switch sends to                 ______________________                                    
  2524.           another switch to attempt to set up a VC to the specified Network                                                __                  _______
  2525.           Address.          _______ 
  2526.  
  2527.                A Clear  is an  indication  that  a  Call  or  VC  is  being                 _____                              ____________           
  2528.           disconnected, a clearing cause is supplied to indicate the reason
  2529.           for the disconnection.
  2530.  
  2531.                A Routing  Alternative is  the list of switches that will be                 ____________________                                      
  2532.           tried when  a Call  Request is  received for  a specific  Network                        _____________                               _______
  2533.           Address.          _______ 
  2534.  
  2535.                A Block  Statement is a collection of commands that effect a                 ________________                                          
  2536.           common item  that was  specified  at  the  start  of  the  block.
  2537.           Examples of  Block Statements are NODE and USER, see below. Block
  2538.           Statements can be nested.
  2539.  
  2540.                A TNC-2  Clone includes, but is not limited to the following                 ____________                                              
  2541.           packet  controllers;   TAPR  TNC-2;   PacComm  TNC-200,   TINY-2,
  2542.           Micropower-2;  AEA   PK-80;  MFJ  1270,  1278  and  is  generally
  2543.           identifiable has a TNC having a Z80 CPU and Z80 SIO/0.
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.             Appendix 5 - Shifted ASCII Table            Appendix 5 - Shifted ASCII Table
  2550.                             Character Hex Value   Shifted
  2551.                                A         41        82
  2552.                                B         42        84
  2553.                                C         43        86
  2554.                                D         44        88
  2555.                                E         45        8A
  2556.                                F         46        8C
  2557.                                G         47        8E
  2558.                                H         48        90
  2559.                                I         49        92
  2560.                                J         4A        94
  2561.                                K         4B        96
  2562.                                L         4C        98
  2563.                                M         4D        9A
  2564.                                N         4E        9C
  2565.                                O         4F        9E
  2566.                                P         50        A0
  2567.                                Q         51        A2
  2568.                                R         52        A4
  2569.                                S         53        A6
  2570.                                T         54        A8
  2571.                                U         55        AA
  2572.                                V         56        AC
  2573.                                W         57        AE
  2574.                                X         58        B0
  2575.                                Y         59        B2
  2576.                                Z         5A        B4
  2577.                                0         30        60
  2578.                                1         31        62
  2579.                                2         32        64
  2580.                                3         33        66
  2581.                                4         34        68
  2582.                                5         35        6A
  2583.                                6         36        6C
  2584.                                7         37        6E
  2585.                                8         38        70
  2586.                                9         39        72
  2587.                              space       20        40
  2588.             
  2589.             Additional values used for SSID's only
  2590.             
  2591.                                10        -         74
  2592.                                11        -         76
  2593.                                12        -         78
  2594.                                13        -         7A
  2595.                                14        -         7C
  2596.                                15        -         7E
  2597.